fcop

fcop-mcp · FCoP 用の標準 MCP アダプター

mcp-name: io.github.joinwell52-AI/fcop

fcop-mcp は、公式の FCoP Python Core を Codex、Cursor、Claude Desktop、その他の MCP クライアントに公開します。これは Core を基盤とする薄いアダプターです。プロトコルに関する事実、検証、状態遷移、永続化、ロック、復旧の唯一の権威は引き続き Core です。

現在のバージョン：4.0.5。 デフォルトのサーバーは、正確に 25 個の標準 MCP ツールと6 個の読み取り専用 Core リソースを公開します。ツールレジストリは、単一の標準マニフェストから生成されます。リソースレジストリは、Core が所有するバージョン管理されたコンテンツを投影します。

インストール

専用の Python 3.10–3.13 環境に、対応する 4.0.5 パッケージのペアをインストールします。

python -m pip install "fcop==4.0.5" "fcop-mcp==4.0.5"

fcop-mcp==4.0.5 は fcop>=4.0.5,<4.1.0 を宣言しています。両方のディストリビューションを確認します。

python -c "from importlib.metadata import version; print('fcop', version('fcop')); print('fcop-mcp', version('fcop-mcp'))"
python -c "from fcop_mcp.server import mcp; print('fcop-mcp ready')"

fcop と fcop-mcp は、同じマイナーバージョン系列内で連動してリリースされます。互換性のないマイナーバージョンを組み合わせないでください。

macOS（Intel および Apple シリコン）

FCoP MCP は Intel と Apple シリコンの両方の Mac に対応しており、Rosetta は不要です。Python 3.10–3.13 の場合：

python3 -m venv ~/.local/share/fcop/venv
~/.local/share/fcop/venv/bin/python -m pip install --upgrade \
  "fcop>=4.0.5,<4.1.0" \
  "fcop-mcp>=4.0.5,<4.1.0"

~/.local/share/fcop/venv/bin/fcop version
~/.local/share/fcop/venv/bin/fcop doctor
~/.local/share/fcop/venv/bin/fcop tools --json

インストールされる CLI には、init、status、inspect、validate、tools、doctor、version、spec、migrate が用意されています。MCP の使用には、ローカル stdio サーバーに対応したクライアントも必要です。コマンドには絶対パス /Users/.../.local/share/fcop/venv/bin/python を設定し、["-m", "fcop_mcp"] を渡して、FCOP_PROJECT_DIR に実際のプロジェクトルートを設定してください。

分離されたランチャーを使用する場合：

uvx --from fcop-mcp==4.0.5 --with fcop==4.0.5 fcop-mcp --root /absolute/path/to/repository

標準の 4.0.5 インターフェース

ワークスペースツールには、init_workspace、inspect_workspace、validate_workspace が含まれます。create_task は、標準の TASK 作成エントリーポイントです。プロファイルは明示的な拡張機能です。Toolkit コマンド、互換性シム、パッケージング操作、Host 設定、Runtime サービス、アプリケーションのスキャフォールディングは、デフォルトの MCP レジストリの対象外です。

チームモデル、Solo モード、ME などの固定ロール、シート、Host セッションは、Base Protocol の前提条件ではありません。デフォルトのサーバーは、それらを要求も作成もしません。init_workspace は、AGENTS.md、CLAUDE.md、Cursor ルール、ロールテンプレート、セッション状態を生成しません。

以前の一覧は、歴史的な 49 ツールの実装範囲です。これは現在の MCP 契約ではありません。過去の各ツールの扱いは、4.0.5 移行ガイドに記載されています。たとえば、write_task はオプトイン方式の非推奨 Python 互換性シムであり、fcop_audit は Toolkit CLI コマンドです。どちらもデフォルトの tools/list には含まれません。

25 個すべての名前、説明、入力スキーマについては、生成された MCP ツールリファレンス を参照してください。

MCP クライアントの設定

固定の仮想環境を使うことで、起動を予測可能にし、別のプロジェクトから異なる編集可能パッケージがインポートされるのを防げます。

{
  "mcpServers": {
    "fcop": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "fcop_mcp", "--root", "/absolute/path/to/repository"]
    }
  }
}

Windows では、command に仮想環境の Scripts\\python.exe を指定します。設定を変更した後は、MCP ホストを再起動してください。

インストールによって行われるのは、パッケージのインストールのみです。ワークスペースの初期化や移行、ルールのデプロイ、Host の指示の変更、他のアプリケーションの設定は行われません。

CLI — セットアップ、確認、診断

CLI = セットアップ + 状況確認 + 診断、MCP = 作業。

コマンド	目的
fcop init	純粋な FCoP ワークスペースを初期化します
fcop status	ワークスペースの状態を確認します
fcop inspect	TASK / REPORT / ISSUE / REVIEW を調査します
fcop validate	プロトコル構造を検証します
fcop tools	インストール済みの MCP カタログを調査します
fcop doctor	インストール、環境、互換性を診断します
fcop version	インストール済みのバージョンを表示します
fcop spec	仕様とルールの識別情報を表示します
fcop migrate	レガシーワークスペースの移行を明示的に計画または適用します

python -m pip install fcop
fcop version
fcop doctor
fcop init --root ./my-project
fcop status --root ./my-project
fcop validate --root ./my-project

python -m pip install fcop-mcp
fcop tools
fcop tools merge_branches --json

ローカル CLI は MCP を起動せずに動作します。fcop tools はサーバーを起動せずに、このアダプターの正式なカタログを読み込みます。create_task、ライフサイクルの遷移、Branch のマージ、認可などの作業操作には、MCP または Python API を使用します。正規の v4 ワークスペース状態は <project>/fcop/ の下に置かれます。fcop doctor はネットワークにアクセスせず、Host の設定も変更しません。

権限とパッケージの境界

オプションの認可 Profile と評価器は、信頼されたアプリケーションから提供される必要があります。ロール名、TASK フィールド、Profile ドキュメント、ツール引数だけでは、権限は付与されません。

パッケージ	責務
fcop	プロトコル Core、検証、アトミックな永続化、復旧
fcop-mcp	25 個の正規 MCP ツールと 6 個の読み取り専用 Core リソース

FCoP はデフォルトでローカル stdio を使用します。Relay のサポートは、明示的に選択できるオプションの追加機能です。Project を直接使用する Python アプリケーションに必要なのは fcop のみです。

中国語の概要

fcop-mcp 4.0.5 は、FCoP Core の薄い MCP アダプターです。デフォルトのサービスは、25 個の正規 MCP ツールと 6 個の読み取り専用 Core リソースを正確に提供します。 Core は、プロトコルの事実と状態遷移に関する唯一の権威です。Team、Solo、ME、seat、Host session、 Profile、Toolkit、Compatibility、Runtime は、いずれも Base Protocol のデフォルトの前提条件にはなりません。 従来の 49 ツールの実装に含まれる各エントリの移行先は、4.0.5 移行ガイドに明記されています。

ドキュメント

• リポジトリ
• 正式なインストールプロンプト（英語）
• 正式なインストールプロンプト（中国語）
• インストールプロンプト MCP リソース
• MCP ツールリファレンス
• 4.0.5 移行ガイド
• プロトコルの概要
• 中国語のプロトコル入門
• 変更履歴

ライセンス

MIT · ライセンス