这是一个完整的本地 MCP 服务器实现，强调以下要点：

• 项目简介

  • 使用 Model Context Protocol（MCP）在本地提供上下文服务，供 LLM 客户端查询和执行工具、读取资源、以及渲染 prompts。
  • 数据存储在本地 SQLite 数据库，全部离线使用，支持导出/导入等操作，便于备份与迁移。

• 主要功能点

  • 提供一组 MCP 风格的工具，如 roadmap_view、ticket_create、ticket_list、ticket_get、task_list、note_add、note_get、note_list、org/project/ticket/task 的创建与查询等，方便 LLM 调用外部功能。
  • 支持 JSON-RPC 风格的请求与响应，服务器内部将请求路由到对应的工具实现。
  • 内部实现包含会话管理、能力声明、以及对多种传输（如标准输入输出、SSE、WebSocket）的扩展准备。
  • 数据模型覆盖 Org/Project/Ticket/Task/Note 等层级结构，含状态、优先级、元数据等丰富字段。
  • 提供 Roadmap 视图、导出/导入、以及迁移工具，方便数据管理和互操作。
  • 通过一个 Python 实现的服务器入口，配合 acquirer 的 MCP 客户端使用（如 Claude 集成）。

• 安装步骤

  • 确保使用 Python 3.10+ 环境。
  • 克隆仓库并进入目录。
  • 使用虚拟环境并安装开发依赖（示例为 uv 工具链的开发用命令，详见仓库 README 的安装说明）：
    • uv venv
    • uv pip install -e .
  • 启动服务器（示例命令，与仓库现有说明保持一致）：
    • uv run --directory /path/to/tpm-mcp tpm-mcp
  • 如需 Claude 集成，请将 MCP 服务器信息添加到 Claude 设置中（具体路径和格式请参考 README 提示）。

• 服务器配置（MCP 客户端需要的配置） 客户端需要的配置包括服务器名称、启动命令及参数，用于与 MCP 服务器建立连接。以下 JSON 为示例描述，实际值请替换为你的部署路径。请注意，这里给出的是注释性描述，非代码块： { "server_name": "technical-project-manager", "command": "uv", "args": ["run", "--directory", "/path/to/tpm-mcp", "tpm-mcp"] } 说明：

  • server_name 对应服务器在代码中的声明名称（技术名称为 technical-project-manager）。
  • command 与 args 指定如何启动 MCP 服务器进程，客户端通过该配置启动并连接到服务器。
  • 该配置仅用于客户端在集成阶段如何启动服务器，实际通信仍通过 MCP 协议进行。

• 基本使用方法

  • 启动服务器后，使用支持 MCP 的客户端（如 Claude 集成等）通过 JSON-RPC 风格的请求与服务器交互。
  • 常用交互包括：获取工具列表、执行工具、查询并渲染 Roadmap、创建/更新 Tickets 与 Tasks、添加和读取 Notes 等。
  • 服务器会以 JSON-RPC 或可推送通知的方式返回结果，具体格式取决于客户端实现。

• 运行与扩展

  • 代码基于标准的 Python 异步风格，具备单元测试与本地数据库支持，便于进一步扩展工具集、数据导入/导出以及 UI 展现。
  • 如需扩展传输协议（如 SSE、WebSocket），可在现有 stdio 服务器基础上实现对应传输层并接入 MCP 的路由逻辑。

• 维护与测试

  • 仓库内含测试用例覆盖数据库操作、工具处理、以及服务器端工具分发行为，建议在改动后执行测试用例以确保 MCP 行为的一致性。