MCP行为
Acture MCP将原始工程信号转化为叙述性报告。
它通过MCP（模型上下文协议）公开来自开发工具（代码、版本控制、问题、文档、任务）的数据，允许AI代理合成结构化、可共享的工程报告。
GitHub是第一个受支持的源代码，计划进行更多集成。
演示
这是给谁的
- 需要每周或冲刺报告的工程经理
- 想要叙事背景而不是原始指标的技术负责人
- 已经使用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 │
└────────────┘- MCP服务器 --将您的仓库数据作为结构化工具公开
- AI 代理 --使用提示请求报告
- 人工智能研究 --通过工具读取提交、PR、问题、文档
- AI写道 --生成带有特定参考的叙述性报告
- 发布到Notion --结构化、可共享、可搜索
- 随时查询 --就报告提出后续问题
安装
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工具：
| 工具 | 目的 |
|---|---|
search_codebase | 搜索提交、PR、问题或代码 |
list_issues | 列出带有过滤器的GitHub问题 |
read_issue | 获取完整的问题详细信息和评论 |
linked_prs | 查找与问题关联的PR |
repo_metrics | 工程指标和DORA数据 |
search_doc | 使用模糊匹配搜索文档 |
read_doc | 阅读完整文档文件 |
publish_notion_report | 将报告发布到Notion |
read_notion_reports | 列出或获取已保存的报告 |
可用提示
三个专门的提示指导报告生成：
| 提示 | 最适合 |
|---|---|
weekly_report | 已发布功能、修复程序、阻止程序的7天摘要 |
milestone_report | Sprint回顾与史诗，速度，学习 |
standup_report | 每日与昨天/今天/拦截器同步 |
自定义提示
提示可编辑 .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