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 创建入口。 配置文件是显式扩展。工具包命令、兼容性垫片、 打包操作、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 中。

请参阅生成的 MCP 工具参考， 了解全部 25 个工具的名称、说明和输入架构。

配置 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。

安装只会安装软件包。它不会初始化或迁移工作区、部署规则、修改 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 · LICENSE