Acture MCP 服务器端实现

关键词

AI代理工程上下文Notion 集成GitHub 数据工具JSON-RPC

使用说明（简要概览，便于快速上手）

  • 项目简介 Acture MCP 服务器是一个基于 MCP（Model Context Protocol）的后端服务，用以向 MCP 客户端提供结构化的数据资源、可调用的工具以及可渲染的提示模板，辅助 AI Agent 生成工程相关的报告或分析，并可将结果发布到 Notion 等目的地。

  • 主要功能点

    1. 资源与数据工具：通过工具对 GitHub、代码、Issues、PR、文档等进行查询和聚合，提供结构化输出给 AI 使用。
    2. 工具与任务执行：内置多种工具（如 search_codebase、list_issues、read_issue、pr_commits、repo_metrics、search_doc、read_doc、Notion 发布/读取等），支持 AI 调用外部功能。
    3. Prompt 模板与渲染：提供 weekly_report、milestone_report、standup_report 三类专用提示模板，便于 AI 以统一格式生成报告内容。
    4. MCP 通讯与扩展性：通过 MCP JSON-RPC 的请求/响应模式进行交互，支持多种传输（如 Stdio），并可扩展其他传输方式。
    5. 安全与本地化：将敏感 Token 本地管理并加密存储，数据处理尽量保留在本地环境，Notion 发布可选对接。

  • 安装步骤

    1. 全局安装（简便方式，适合快速试用）
      • 使用 npm 安装 Acture MCP：npm install -g acture-mcp
      • 按提示完成初始化与配置（init/sync 等命令），确保配置了 GitHub Token、仓库、本地同步路径等信息。
    2. 本地开发/自定义安装
      • 克隆仓库、安装依赖、构建服务器并启动，通常通过 bin/acture-mcp-server 直接启动（具体入口在 bin/ 目录，根据你的运行方式选择 npx 或 node 启动）。
    3. 配置 MCP 客户端（用于与 MCP 服务器建立连接）
      MCP 客户端需要一个简单的配置 JSON，指明要连接的服务器信息、启动命令及参数等。示例配置如下（请根据实际环境替换路径和参数）：
      { "server": "acture-mcp", "command": "npx", "args": ["acture-mcp-server"] } 说明：server 为 MCP 服务器的标识，command 是启动服务器的命令，args 是启动参数。若你本地直接使用本仓库的服务器入口，请将 command 设置为 node，args 设置为你服务器入口的实际路径，例如 ["path/to/acture-mcp/bin/acture-mcp-server"]。
    4. 运行与验证
      • 启动服务器后，确认服务器在指定传输（如 stdio、WebSocket、SSE 等）可用。
      • 在 MCP 客户端（如 Claude Desktop 等）配置好服务器后，可以通过内置 prompts（weekly_report、milestone_report、standup_report）发起请求，服务器会执行对应工具并渲染报告内容，必要时可将结果发布到 Notion。

  • 服务器配置（供 MCP 客户端使用的 JSON 配置示例，非代码，仅说明格式） 服务器标识: acture-mcp 启动命令: npx 启动参数: ["acture-mcp-server"] 备注: 这是最常用的全局安装场景。如使用本地版，请将命令改为 node，参数为实际的启动脚本路径。 上述信息以 JSON 如下表示（请按需替换路径与模式）： { "server": "acture-mcp", "command": "npx", "args": ["acture-mcp-server"] } 另一个常见场景（本地安装）： { "server": "acture-mcp", "command": "node", "args": ["path/to/acture-mcp/bin/acture-mcp-server"] }

  • 基本使用方法

    1. 通过 MCP 客户端触发报表请求，如：
      • /weekly_report：生成本周工程总结
      • /milestone_report：本次冲刺回顾
      • /standup_report：每日站会摘要
    2. AI 将自动进行数据检索（代码变更、Issue、PR、文档等），并通过工具输出；随后渲染成结构化报告，必要时发布到 Notion。
    3. 如果需要查看历史报告或对之前的 Notion 报告进行查询，可以通过服务器提供的查询工具进行检索与读取。
    4. 如需排错，可查看服务器日志与 MCP 错误输出，必要时重启服务并重新配置权限。

  • 相关依赖与注意事项

    • 需要 Node.js 16+、git、以及可选的 GitHub/Notion 账户作为数据源与发布端。
    • Notion、Claude Desktop 等客户端为可选集成，具体取决于你的工作流。
    • 安全性方面，GitHub/Notion 的 Token 以加密方式本地存储，尽量在受信环境中使用。

  • 关键词 AI代理, 工程上下文, Notion 集成, GitHub 数据工具, JSON-RPC

  • 分类 6

服务器信息

访问项目