TPC 服务器 - 模型上下文协议 (MCP) 实现

一个生产就绪的 MCP 服务器，用于通过想法、计划和变更日志 (TPC) 条目跟踪 AI 团队的协作。 使用 SQLAlchemy async 和 FastMCP 构建，针对软件开发协作进行了优化。

---

特性

✅ 结构化协作

• 跟踪决策制定（想法）、任务协调（计划）和进度（变更日志）
• 复杂工作流程的依赖管理
• 关键设计决策的不确定性标记

✅ 性能优化

• 带有连接池的 Async SQLAlchemy 2.0
• 用于按时间顺序追溯的时间排序 UUID (UUID7)
• 带有 5 分钟 TTL 的缓存查询

✅ 开发者友好

• 完全符合 MCP 接口
• 用于数据访问的类 REST 资源端点
• 全面的 Pydantic 验证

---

快速开始

# 1. 克隆仓库
git clone https://github.com/suttonwilliamd/tpc-server.git
cd tpc-server

# 2. 安装依赖
pip install -r requirements.txt

# 3. 运行服务器（自动创建 SQLite）
uvicorn main:mcp --reload --port 8000

---

核心概念

1. 想法

# 记录设计决策或不确定性
create_thought(
    content="选择 React 而不是 Vue 作为前端",
    plan_id="pl_frontend_123",
    uncertainty_flag=True
)

2. 计划

# 定义具有依赖关系的任务
create_plan(
    description="实现用户身份验证",
    dependencies=["pl_database_setup", "pl_security_audit"]
)

3. 变更日志

# 跟踪实施进度
log_change(
    plan_id="pl_auth_456",
    description="添加了 JWT 令牌端点",
    thought_ids=["th_design_decision_789"]
)

---

高级用法

AI 代理集成

# 示例 pre-commit hook 验证
modified_files = get_git_changes()
tpc_entries = query_tpc_server()

for file in modified_files:
    if not has_corresponding_tpc_entry(file, tpc_entries):
        raise Exception(f"缺少 {file} 的 TPC 条目")

API 参考

端点	方法	描述
/mcp/thoughts	POST	创建新想法
/mcp/plans	POST	定义具有依赖关系的新计划
/mcp/changelog	POST	记录实施变更
/mcp/plans/{id}	GET	获取具有依赖关系的计划详细信息

---

架构

graph TD
    A[想法] -->|参考| B(计划)
    B -->|依赖于| B
    C[变更日志] -->|链接| A
    C -->|跟踪| B

---

生产环境设置

# 最佳部署
uvicorn main:mcp \
  --host 0.0.0.0 \
  --port 8000 \
  --workers 1 \  # 推荐用于 SQLite
  --proxy-headers

---

贡献

1. Fork 仓库
2. 创建特性分支 (git checkout -b feature/tpc-enhancements)
3. 提交更改 (git commit -am 'Add new feature')
4. 推送分支 (git push origin feature/tpc-enhancements)
5. 打开 pull request

---

灵感来自 Awesome MCP Servers 社区。 有关 MCP 客户端实现，请参阅 FastMCP 文档。