Acture MCP

MCP行为

Acture MCP将原始工程信号转化为叙述性报告。

它通过MCP（模型上下文协议）公开来自开发工具（代码、版本控制、问题、文档、任务）的数据，允许AI代理合成结构化、可共享的工程报告。

GitHub是第一个受支持的源代码，计划进行更多集成。

演示

Demo

这是给谁的

• 需要每周或冲刺报告的工程经理
• 想要叙事背景而不是原始指标的技术负责人
• 已经使用GitHub+Notion的团队
• 开发人员正在试验MCP驱动的工作流

它的作用

输入：

• 源代码和提交
• 拉取请求和差异
• 问题和任务
• 文档

输出：

• 每周工程总结及具体参考
• 基于实际工作的Sprint/里程碑回顾
• 根据实际活动生成的每日站立报告
• 通过提示定义的任何自定义报告

所有存储为结构化的Notion页面，您可以稍后共享、搜索和引用。

运作原理

┌─────────────────────┐     ┌──────────────┐     ┌────────────────────┐
│ Engineering Signals │───▶│  Acture MCP  │───▶│  AI Agent (Claude   │
│ (GitHub, etc)       │     │  Server      │     │ Desktop or others) │
└─────────────────────┘     └──────────────┘     └────────────────────┘
                               │                        │
                               ▼                        ▼
                        ┌─────────────┐            ┌─────────────┐
                        │  Tools:     │            │  Prompt:    │
                        │ - Commits   │            │ "Create     │
                        │ - Issues    │            │ weekly      │
                        │ - PRs       │            │ report"     │
                        └─────────────┘            └─────────────┘
                               │                        │
                               ▼                        ▼
                        ┌─────────────────────────────────────┐
                        │  AI synthesizes narrative report    │
                        │  referencing concrete commits, PRs  │
                        └─────────────────────────────────────┘
                                          │
                                          ▼
                                   ┌────────────┐
                                   │   Notion   │
                                   │   Page     │
                                   └────────────┘

1. MCP服务器 --将您的仓库数据作为结构化工具公开
2. AI 代理 --使用提示请求报告
3. 人工智能研究 --通过工具读取提交、PR、问题、文档
4. AI写道 --生成带有特定参考的叙述性报告
5. 发布到Notion --结构化、可共享、可搜索
6. 随时查询 --就报告提出后续问题

安装

npm install -g acture-mcp

或者克隆并在本地安装：

git clone https://github.com/vkhafizov/acture-mcp.git
cd acture-mcp
npm install
npm link

快速设置

只需一个命令即可配置所有内容：

acture-mcp init

此交互式设置将要求：

• GitHub代币 -用于API访问（存储加密）
• 仓库 --要分析的repo（格式： owner/repo)
• 本地路径 --在哪里本地同步仓库
• 文档路径 --包含项目文档的本地目录（可选，用于文档搜索）
• 概念整合 --可选，用于发布报告

然后同步您的存储库：

acture-mcp sync

这会将仓库克隆/拉到您的本地路径，以进行快速代码搜索。

配置您的代理。Claude Desktop示例：

添加到您的Claude桌面配置(claude_desktop_config.json):

如果通过npm（全局）安装：

{
     "mcpServers": {
       "acture-mcp": {
         "command": "npx",
         "args": ["acture-mcp-server"]
       }
     }
   }

如果本地安装（克隆）：

{
  "mcpServers": {
    "acture-mcp": {
      "command": "node",
      "args": ["path to acture-mcp/bin/acture-mcp-server"]
    }
  }
}

配置位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%/Claude/claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

重新启动克劳德桌面。您应该看到可用的工具和提示。

用法

1.要求提交报告

在Claude Desktop中，使用内置提示之一：

/weekly_report --生成每周工程总结

“创建一份报告，涵盖团队本周发布的内容，包括具体的PR及其影响。”

/milestone_report --Sprint/里程碑回顾

“总结冲刺：计划了什么，交付了什么，遇到了阻碍，吸取了教训。”

/standup_report --每日站立总结

“记录今天完成的工作、当前进度和任何阻碍。”

2.人工智能进行研究

AI将自动：

• 呼叫 repo_metrics 活动数据
• 通过以下方式搜索提交和PR search_codebase
• 列出最近的问题 list_issues
• 阅读具体问题详情 read_issue
• 搜索文档 search_doc （如果配置了文档路径）

它找到了实际的工作——具体的提交、真正的PR、具体的问题。

3.审查和发布

人工智能展示了调查结果并询问：

• “你有什么特别想强调的吗？”
• “我可以把这篇文章发表给Notion吗？”

说“是”，它就会召唤 publish_notion_report --你的报告是实时的。

4.稍后查询

询问有关任何已保存报告的后续问题：

“在上周的报告中，我们使用了哪些阻断剂？”

“显示1月15日的里程碑报告”

AI使用 read_notion_reports 获取并解释之前的报告。

可用工具

Acture MCP向您的AI代理公开以下MCP工具：

可用提示

三个专门的提示指导报告生成：

自定义提示

提示可编辑 .txt 文件在 src/server/prompts/:

• weekly-report.txt --周报说明
• milestone-report.txt --里程碑评审说明
• standup-report.txt --站立报告说明

编辑这些以更改生成报告的方式。重新启动Claude Desktop以应用更改。

报告结构

报告是灵活的。AI包括其拥有数据的部分：

• 叙述概述 --这一时期的故事
• 主要业绩及成果 --具体功能、修复、改进
• 贡献者 --谁干了什么
• 影响 --为什么工作很重要
• 阻碍 --当前障碍（如有）
• 指标 --上下文中的数字（不是独立的）
• 展望未来 --下一个优先事项

存储

已发布的报告在本地跟踪：

~/.config/acture-mcp/notion-reports.json       (Linux)
~/Library/Application Support/...               (macOS)
%APPDATA%/acture-mcp/...                        (Windows)

存储：ID、URL、标题、模板类型、创建日期。保留了最后100份报告。

命令

acture-mcp init       # Configure (token, repo, Notion)
acture-mcp sync       # Clone/pull repository
acture-mcp status     # Check configuration and sync status

需求

• Node.js 16+
• 版本控制系统
• GitHub帐户（用于API令牌）
• Notion帐户（可选，用于发布）
• Claude Desktop或其他MCP兼容代理

安全

• 加密存储的GitHub令牌（AES-256-CBC）
• Notion令牌已加密存储
• 除了Notion API调用之外，所有数据都保持本地

许可证

Apache许可证2.0

贡献与合作

Acture MCP正在积极开发中。欢迎问题、分叉和贡献。

• 打开一个问题 对于问题、想法或集成请求，这是首选的起点。
• 鼓励分叉，特别是对于新的数据源、MCP工具或报告样式。
• 我们赞赏小型、重点突出的PR和文件改进。

付费飞行员

如果你想在你的团队中定制、扩展或实施Acture MCP，我对付费试点和设计合作伙伴关系持开放态度。

通过GitHub问题或电子邮件联系： khafizov.vr@gmail.com