脉冲MCP
MCP服务器，用于跟踪GitHub、Jira和Confluence上的工程工作。专为 所有人 在团队中——无论是跟踪自己的工作还是支持他人。
这是给谁的？
个人贡献者
跟踪自己的贡献，设定目标，并为晋升和评论建立自己的叙述。
- “这个季度我运送了什么？”
- “生成我的吹嘘文档以进行推广”
- “写下我的自我评估”
- “增加一个目标，到第二季度出货10个PR”
- “我上周做了什么？”→ 自动生成每周更新
- “Journal：在身份验证重构方面进行了很好的配对”
技术主管和经理
了解团队贡献并简化人员流程。
- “莎拉这周送了什么？”
- “为我和亚历克斯的1:1做准备”
- “起草约旦业绩审查”
- “显示团队的贡献趋势”
快速入门（仅限GitHub）
最快的入门方式-只需GitHub，不需要Jira/Confluence。
# 1. Clone and setup
git clone https://github.com/harrisonju123/pulse-mcp.git
cd pulse-mcp
./setup.sh
# 2. Get a GitHub token
# → https://github.com/settings/tokens
# → Generate new token (classic) → select 'repo' scope
# 3. Edit config.json with your token and team最小config.json（个人使用）：
{
"self": "your-github-username",
"github": {
"token": "ghp_your_token_here",
"org": "your-github-org",
"repos": []
},
"team_members": {
"your-github-username": { "atlassian_account_id": "N/A", "name": "Your Name" }
}
}这 "self" 字段支持个人功能：目标、日记、自我评估、吹嘘文档和每周更新。
你也想追踪队友吗？ 只需将它们添加到 team_members.
安装脚本打印MCP配置以复制到Claude Code或Cursor中。添加后重新启动。
你能做什么
为自己（IC模式）
"What did I ship last month?"
"Write my weekly update" → /weekly-update
"Generate my brag doc" → /brag-doc
"Write my self-assessment" → /self-assessment
"Add a goal: improve test coverage to 80%"
"Show my active goals"
"Journal: finally cracked the caching bug"为您的团队
"What did @alice ship in the last 2 weeks?"
"Show me contribution trends for the team"
"Who reviewed the most PRs this month?"
"Prep for my 1:1 with Bob" → /one-on-one-prep
"Draft a review for Carol" → /performance-review计划和跟踪工作（需要Jira）
"Show the roadmap for INITIATIVE-123"
"What's the team's bandwidth?"
"Search for open bugs in PROJ"添加Jira和Confluence
展开你的config.json：
{
"github": { ... },
"confluence": {
"base_url": "https://yourcompany.atlassian.net/wiki",
"email": "you@company.com",
"api_token": "your-atlassian-token",
"space_keys": ["ENGINEERING", "DOCS"]
},
"jira": {
"base_url": "https://yourcompany.atlassian.net",
"email": "you@company.com",
"api_token": "your-atlassian-token",
"project_keys": ["PROJ", "TEAM"],
"story_point_field": "customfield_10016",
"epic_link_field": "customfield_10014"
},
"team_members": {
"github-username": {
"atlassian_account_id": "712020:abc123-...",
"name": "Full Name"
}
}
}获取Atlassian API代币：https://id.atlassian.com/manage-profile/security/api-tokens
MCP配置
运行后 ./setup.sh，将打印的配置添加到：
| 应用程序 | 配置文件 |
|---|---|
| 克劳德代码 | ~/.claude/mcp_settings.json |
| 光标 | ~/.cursor/mcp.json |
然后重新启动应用程序。
可用工具
| 工具 | 说明 |
|---|---|
get_github_contributions | PR合并，给出评论，更改行 |
get_member_pulse | 某人发货的定性总结 |
get_pr_details | 通过文件分类深入了解特定的公关 |
get_contribution_trends | 每周或每月趋势 |
get_contribution_distribution | 按仓库、文件类型、区域工作 |
get_teams | 列出已配置的团队 |
get_team_members | 列出团队成员 |
get_confluence_contributions | 创建/更新的页面、评论 |
get_initiative_roadmap | Epics在一项有进展的倡议下 |
get_team_bandwidth | 团队间的工作分配 |
search_jira_issues | 灵活的JQL搜索 |
| IC工具 | |
add_goal | 添加个人/职业目标和关键成果 |
get_goals | 列出目标（按状态筛选） |
update_goal_progress | 更新目标状态，添加进度说明 |
add_journal_entry | 使用标签添加个人反思 |
get_journal_entries | 按日期范围获取日记条目 |
search_journal | 按关键字搜索期刊 |
技能（克劳德代码）
对于每个人：
| 技能 | 它做什么 |
|---|---|
/weekly-update | 生成您的每周状态报告 |
/self-assessment | 反思你最近的工作和成长 |
/brag-doc | 为促销包生成完成摘要 |
/pulse [name] | 某人（或你）发货的定性总结 |
对于经理/潜在客户：
| 技能 | 它做什么 |
|---|---|
/one-on-one-prep [name] | 与阻挠者、目标、讨论主题进行会议准备 |
/performance-review [name] | 使用贡献数据起草审查报告 |
多团队支持
将成员组织成团队：
{
"teams": {
"platform": {
"name": "Platform Team",
"members": {
"alice": { "atlassian_account_id": "...", "name": "Alice" },
"bob": { "atlassian_account_id": "...", "name": "Bob" }
}
},
"product": {
"name": "Product Team",
"members": {
"carol": { "atlassian_account_id": "...", "name": "Carol" }
}
}
}
}然后问：“平台团队运送了什么？”或“/pulse平台”
个人跟踪功能
集 "self": "your-github-username" 在config.json中解锁个人生产力工具：
目标
使用OKR风格的关键结果跟踪个人和职业目标：
"Add a goal to ship 10 PRs by Q2"
"Show my active goals"
"Update goal: shipped 7/10 PRs"目标存储在 goals/{username}-goals.json.
期刊
个人反思和笔记：
"Add a journal entry about today's work"
"Show my journal entries from last week"
"Search my journal for 'performance review'"日记条目以markdown形式存储在 reflections/{username}/YYYY-MM-DD.md 带有标签。
审核目标文件
对于绩效评估，请将目标存储在 goals/.md:
cp goals/TEMPLATE.md goals/alice-smith.md
# Edit with their goals这 /performance-review 技能使用这些来评估目标。
自定义参考文档
绩效评估技能使用参考文件 .claude/skills/performance-review/references/.
要为您的公司进行自定义，请执行以下操作：
- 复制
engineering-growth-framework.example.md→engineering-growth-framework.md - 复制
engineering-growth-rubric.example.md→engineering-growth-rubric.md - 使用贵公司的实际框架进行编辑
这些文件是合法的，因此您的内部文档是保密的。
故障排除
验证您的配置：
.venv/bin/python server.py --validate常见问题：
| 问题 | 解决方案 |
|---|---|
| MCP服务器未加载 | 检查MCP配置中的路径是否为绝对路径，重新启动应用程序 |
| 401个错误 | 重新生成API令牌，检查其作用域是否正确 |
| 空结果 | 检查日期范围，验证用户名是否正确 |
| 未知团队成员 | GitHub用户名区分大小写 |
查找Atlassian帐户ID：
- 转到他们的Confluence个人资料
- URL包含：
/wiki/people/712020:abc123-... - 复制零件后
/people/
查找Jira自定义字段ID:
- 将任何问题导出到XML
- 搜索您的故事点值
- 字段ID看起来像
customfield_10016
手动设置
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp config.example.json config.json
# Edit config.json
python server.py --validate许可证
麻省理工学院