board-mcp
一个MCP小工具，MCP公告板，可以让ai工具协调工作。
多终端 AI 协作公告板 MCP 服务器。让并行工作的 Claude Code / Codex / OpenCode / Trae在撞车前协调好"谁在改哪个文件"。
安装（只注册 MCP 工具）
要求：Python 3.10+、uv，以及至少一个目标终端。
git clone https://github.com/maoxiangzhe/board-mcp.git
cd board-mcp
uv run python install.py # 自动建 .venv + 装依赖 + 检测已装 CLI 并注册
uv run python install.py --target all # 注册到全部 4 个终端
uv run python install.py --target codex # 只注册 Codex（可逗号分隔多个）
uv run python install.py --dry-run # 演练：只看不改
uv run python install.py --check # 检查注册状态
uv run 会自动创建 .venv、按 uv.lock 装依赖（唯一依赖 mcp SDK），并用 .venv 里的 Python 注册服务器——不污染系统 Python。
| 终端 | MCP 注册位置 |
|---|---|
| Claude Code | claude mcp add board（幂等，路径不一致自动重注册） |
| Codex | ~/.codex/config.toml → [mcp_servers.board-mcp]（保留 tools.* 权限子段） |
| OpenCode | ~/.config/opencode/opencode.json → mcp.board |
| Trae | %APPDATA%\Trae CN|Trae\User\mcp.json → mcpServers.board |
装完重启对应终端会话，即可使用 7 个工具：get_board / claim_files / report_done / check_conflict / release_claim/ post_decision / init_bulletin。
- 幂等可重复执行，改动前自动备份到
%TEMP%\board_install_backup\ --project只影响 Claude 的注册范围，其余终端按用户级安装
协作规则
每个项目第一次使用时调用 init_bulletin 初始化公告板，之后按流程走：开工 get_board → 认领 claim_files → 干活 → 收尾 report_done。项目根目录的 AGENTS.md / CLAUDE.md 会自动注入协作纪律（见 template.md）。
数据存放
- 公告板实体：
~/.board-mcp/boards/<项目ID>.md（所有终端共享同一份） - 日志：
~/.board-mcp/logs/server.log；心跳：~/.board-mcp/run/ - 可调环境变量：
BOARD_MCP_ROOT（数据目录）、BOARD_MCP_PROJECT（强制项目身份）、BOARD_CLAIM_TTL_MINUTES（认领过期，默认 120 分钟）
结构
board-mcp/
├── server.py # MCP 服务器（公告板引擎）
├── install.py # 多终端 MCP 注册安装器
├── test_demo.py # 自测（12 项断言，CI 自动跑）
├── template.md # 注入项目的协作规则模板
├── AGENTS.md # AI 协作纪律（本目录）
├── CLAUDE.md # Claude Code 规则副本
├── LICENSE # MIT
├── pyproject.toml # 项目元数据 + 依赖声明（mcp SDK）
├── uv.lock # 依赖锁（uv sync 精确还原环境）
└── .gitignore # 忽略 .venv / __pycache__ / 备份
