Pyrus AI エコシステム — MCP インフラストラクチャ

このリポジトリは、Pyrus MCP インフラストラクチャサービスとその支援AIエンジニアリングチームの実装および運用管理の拠点です。また、今後の Knowledge MCP のアーキテクチャ仕様とロードマップも含まれています。これは独立したデータストアとライフサイクルを持つ別のサービスです。

製品境界

AI clients / employees
        |
        +---------------------+
        |                     |
        v                     v
   Pyrus MCP             Knowledge MCP
   Pyrus actions         canonical knowledge
        |                     |
        v                     v
     Pyrus API          PostgreSQL/pgvector
        ^                     ^
        |                     |
        +------- PyrusBot ----+
             orchestration

Pyrus MCP

承認された従業員/AIホストがMCP経由でPyrus操作を実行できるようにする、プロダクション向けの外部サービスです。独立してデプロイ可能であり、開発者ワークステーションに依存してはなりません。

Knowledge MCP

正規のバージョン管理されたドキュメント、証拠/系統、セマンティック埋め込み、ハイブリッド検索、およびPyrus MCPを介したPyrus Knowledge Baseへの管理された公開のための、独立したMCPサービスです。

PyrusBot

将来のオーケストレーション/アプリケーションレイヤーであり、両方のMCPを利用します。後日、チャットボット、CLI、Webユーティリティ、IDEアダプターになる可能性がありますが、インフラストラクチャの契約は変更されません。

Related MCP server: MCP Gateway

現在の優先順位

Pyrus MCP のプロダクション準備が最優先です。 Knowledge MCP は並行して仕様化されますが、その契約が承認された後に実装されます。PyrusBot の統合は、安定したインフラストラクチャ契約に続いて行われます。

規範文書

• IMPLEMENTATION_PLAN.md — 規範的な実装入門ポイント。

• docs/architecture/system-architecture-v2.md — 完全なシステムアーキテクチャ。

• docs/architecture/contracts-v2.md — MCP、Pyrus API、セキュリティ、Webhook、Knowledge の契約。

• docs/planning/production-roadmap-v2.md — フェーズロードマップと並列化ルール。

• tasks/registry.yaml — 所有者、レビュアー、ゲート、依存関係を含む実行可能なタスクグラフ。

• contracts/pyrus-tool-catalog.yaml — 復元可能なレガシー互換性カタログ。現在、レガシー証拠が復元されるまでブロックされています。

• docs/qa/gates.md — マージ/リリース/プロダクション受け入れゲート。

• docs/ai-team/agent-registry.yaml — エンジニアリングの役割と権限。

現在の重大なブロッカー

1. 以前の計画では pyrus_mcp_tools_spec.json と inventory.json が参照されていましたが、現在のリポジトリにはそれらの成果物が存在しません。1対1のパリティを宣言する前に、正確なレガシー契約を復元する必要があります。

2. 表示されている計画には「61のツール」とありますが、現在表示されているグループ化されたリストは独立してその数と一致しません。したがって、正確なレガシー数と名前はP0契約復旧タスクです。

3. 単一の SERVER_AUTH_TOKEN は、マルチユーザープロダクション認証モデルとして適切ではありません。目標は、MCP/OAuth互換のベアラー認証、オーディエンス検証、スコープ、テナントバインド、失効、監査です。

4. SQLite はローカル開発オプションであり、永続的なプロダクションシステムの記録ではありません。

エンジニアリングスタック

Pyrus MCP

Python 3.11+ ポリシー; uv; FastMCP; Streamable HTTP; ローカルテスト用 stdio; Pydantic; httpx; pytest; Ruff; 静的型付け; PostgreSQL; オプションの Redis; Docker; GitHub Actions; 外部シークレット管理。

Knowledge MCP

Python + FastMCP; PostgreSQL + pgvector; 大規模/生アーティファクト用オブジェクトストレージ; モデル/バージョンレコード付き埋め込みプロバイダーアダプター; バックグラウンドインデックス/埋め込みジョブ; オプションの Redis; 同じプロダクションセキュリティおよび可観測性の規律。

開発モデル

すべての実装項目には、1人の主要な実行者、独立したレビュアー、および明示的なゲート所有者がいます。タスクは、独立してテスト可能な成果が複数含まれている場合に分割されます。新しい発見により、範囲を黙って拡大するのではなく、リンクされたタスクが作成されます。

プロダクションリリースは、アーキテクチャ、契約、セキュリティ、QA、永続性、可観測性、ステージング、リリースチェックによってゲートされます。

便利なコマンド

node scripts/dashboard-server.mjs
# Open http://localhost:4748/

ダッシュボードはタスクレジストリへのインターフェースです。レジストリと上記の文書が真実の情報源であり続けます。