内容
# Felix 独立 MCP 服务器
**带有 PASH 压缩的独立 MCP 服务器（凤凰架构）**
该项目是一个最小化、生产就绪的模型上下文协议（MCP）服务器，从 Felix 生态系统中提取。它旨在为外部工具（Cursor、Claude Desktop 等）提供最大程度的代币节省，借助内置的 PASH 压缩。
## 特点（凤凰架构）
- **纯净内核**：与 Felix 单体代码库没有隐藏的依赖。
- **动态注册**：自动扫描 `mcp_engines` 目录，并从 `manifest.json` 加载工具。
- **PASH 压缩**：智能压缩大型 JSON 响应（节省 >80% 代币），并透明地返回哈希值。
- **零配置启动**：通过 `stdio` 工作，并通过 `.env` 配置。
## ⚠️ 安全性和运行时
对于修改服务器端（`sse_server.py`，测试）的开发者：严格遵守 **[端口手术过程清理](docs/RUNTIME_SAFETY.md)** 模式。全局进程终止（`taskkill /IM`）是严格禁止的，因为它会中断代理会话。
## 架构边界
**Felix MCP 独立版** 是一个独立的产品。它与内部 Felix 核心（`C:\Users\53\Felix`）**共享原则，而不是代码**。
- **产品评估器**（在 `src/product_judge.py` 中）是确定性验证的独立实现。它与内部 Mirror Forge 合成共享“输出前结构验证”的原则，但设计上没有共享代码。这是故意防止技术债务。
- **认知循环和 PASH 压缩** 直接在此仓库中实现。它们不从内部 Felix 核心导入或依赖。这确保产品可以独立部署、测试和维护。
**为什么这很重要：** 当您安装此软件包时，您将获得一个完整、自主的系统。内部基础设施上没有隐藏的依赖。
## 安装
```bash
git clone https://github.com/AkynZH/pash-mcp-server.git
cd pash-mcp-server
pip install -e .
```
## 配置
复制 `.env.example` 到 `.env` 并配置路径：
```env
MCP_ENGINES_DIR=./mcp_engines
LOG_LEVEL=INFO
PASH_MIN_THRESHOLD=500
```
创建 `mcp_engines` 目录并在其中放置带有 `manifest.json` 和 MCP 服务器可执行文件的子目录。
## 启动
```bash
python server.py
```
服务器将在 `stdio` 模式下启动，并准备好通过兼容的客户端（例如 Claude Desktop）连接。
## 项目结构
```
pash-mcp-server/
├── server.py # 入口点（FastMCP）
├── src/
│ ├── config.py # Pydantic 配置
│ ├── router.py # 扫描器和 JSON-RPC 代理
│ └── compressor.py # PASH 压缩核心
├── config/
│ └── manifest.example.json # 清单示例
└── tests/ # 隔离测试
```
## Odysseus 集成状态
该仓库用作认知核心，旨在与 Odysseus 等接口配对。
- ✅ **已完成并已交付：** 认知循环、PASH 压缩、产品评估器和启发式路由已完全实现和测试。
- 🗺️ **路线图：** Odysseus 代理的本地、单击 UI 集成（将本地反射与此认知核心结合）目前正在积极开发中。
*我们相信交付有效且明确标记正在构建的内容。*
## 许可证
MIT License (c) 2026 AkynZH
MCP 市场