pash-mcp-server

Felix Standalone MCP サーバー

PASH 圧縮機能を備えたスタンドアロン MCP サーバー（Phoenix Architecture）

このプロジェクトは、Felix エコシステムから切り出した、最小構成で本番環境に対応した Model Context Protocol（MCP）サーバーです。組み込みの PASH 圧縮により、トークンを最大限節約しながら、Cursor、Claude Desktop などの外部ツールを利用できるように設計されています。

特徴（Phoenix Architecture）

• クリーンなコア：Felix のモノリシックなコードベースへの隠れた依存関係はありません。
• 動的登録：mcp_engines ディレクトリを自動的にスキャンし、manifest.json からツールを読み込みます。
• PASH 圧縮：大きな JSON レスポンスをインテリジェントに圧縮し、ハッシュを透過的に返すことで、トークンを 80% 以上節約します。
• ゼロコンフィグで起動：.env による設定で stdio 経由で動作します。

⚠️ セキュリティとランタイム

サーバーサイド（sse_server.py、テスト）に変更を加える開発者は、ポート単位の外科的なプロセスクリーンアップ のパターンを厳守してください。グローバルなプロセスの強制終了（taskkill /IM）はエージェントのセッションを中断するため、固く禁止されています。

アーキテクチャの境界

Felix MCP Standalone は自己完結型の製品です。内部の Felix コア（C:\Users\53\Felix）とは、コードではなく原則を共有します。

• src/product_judge.py の Product Judge は、決定論的な検証を独立して実装したものです。内部の Mirror Forge Synthesis とは「出力前に構造を検証する」という原則を共有していますが、設計上、コードは一切共有していません。これは意図的な技術的負債の予防策です。
• Cognitive Loop と PASH 圧縮は、このリポジトリ内に直接実装されています。内部の Felix コアからインポートしたり、依存したりすることはありません。これにより、製品を独立してデプロイ、テスト、保守できます。

これが重要な理由： このパッケージをインストールすると、完全に自律したシステムを利用できます。内部インフラストラクチャへの隠れた依存関係はありません。

インストール

git clone https://github.com/AkynZH/pash-mcp-server.git
cd pash-mcp-server
pip install -e .

設定

.env.example を .env にコピーし、パスを設定します。

MCP_ENGINES_DIR=./mcp_engines
LOG_LEVEL=INFO
PASH_MIN_THRESHOLD=500

mcp_engines ディレクトリを作成し、その中に manifest.json と MCP サーバーの実行ファイルを含むサブディレクトリを配置します。

起動

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 のようなインターフェイスと組み合わせることを想定して設計された認知コアです。

• ✅ 完了・リリース済み： Cognitive Loop、PASH 圧縮、Product Judge、ヒューリスティックルーティングはすべて実装され、テスト済みです。
• 🗺️ ロードマップ： Odysseus エージェントとのネイティブなワンクリック UI 統合（ローカルの反射機能とこの認知コアを組み合わせる機能）は、現在活発に開発中です。

動作するものをリリースし、開発中のものは明確に示すことを大切にしています。

ライセンス

MIT License (c) 2026 AkynZH