jellyfish-mcp: A Jellyfish MCP Server

Jellyfish MCP 服务

安全提示：此实现存在已知风险和固有限制。使用前请参阅 SECURITY.md。

重要

此服务未捆绑 PromptGuard。我们建议您在日常使用 jellyfish-mcp 前进行配置——请参阅 PROMPTGUARD.md 了解设置方法，并在使用前阅读 SECURITY.md。

概述

一个用于从 Jellyfish API 获取和分析数据的 Model Context Protocol 服务。此服务允许主机（例如 Claude Desktop 或 Cursor）与您的 Jellyfish 实例交互，从而能够以自然语言查询有关工程指标、团队数据以及 Jellyfish API 提供的其他信息。

连接 Jellyfish MCP 后，您可以询问有关 Jellyfish 数据的问题，例如：

• “我们公司在 2026 年 5 月的指标是什么？”
• “能否列出我所在组织的团队？”
• “上个月有哪些未关联的拉取请求？”

安装

完整设置指南请参阅 INSTALL.md。快速链接：

• Claude Desktop — 下载 .mcpb 扩展，然后双击安装
• Claude Code、Cursor、VSCode — npx jellyfish-mcp-server@latest（推荐）或 Docker

开发

想要修改源代码或从本地克隆版本运行？请参阅 DEVELOPMENT.md。

工具和资源

此服务提供多个用于与 Jellyfish API 交互的工具。每个工具对应一个特定的 Jellyfish API 端点，可让您按照 API 中的说明检索或搜索数据。

常规

• api_schema - 获取包含所有可用 API 端点的完整 API 架构
• get_current_date - 返回指定时区的今天日期

AI 影响

• ai_company_adoption_analytics
• ai_company_impact_analytics
• ai_person_adoption
• ai_person_adoption_analytics
• ai_team_adoption_analytics
• ai_team_impact_analytics

人员分配

• allocations_by_person
• allocations_by_team
• allocations_by_investment_category
• allocations_by_investment_category_person
• allocations_by_investment_category_team
• allocations_by_work_category
• allocations_by_work_category_person
• allocations_by_work_category_team
• allocations_filter_fields
• allocations_summary_by_investment_category
• allocations_summary_by_work_category

交付

• deliverable_scope_and_effort_history
• work_categories
• get_deliverable
• search_deliverables

开发者体验

• devex_insights_by_team

指标

• company_metrics
• person_metrics
• team_metrics
• team_sprint_summary
• unlinked_pull_requests

人员

• list_engineers
• search_people

团队

• list_teams
• search_teams

帮助中心

• search_articles
• get_article

技能

除了上述 MCP 工具外，Jellyfish MCP 还支持可选的 Agent 技能。技能也可以在整个聊天过程中调用，但不会与 MCP 捆绑，需要单独安装。要在 Claude Desktop 中安装技能，请从最新版本下载其 .skill 文件，然后双击安装。对于其他宿主应用，请直接从 skills/ 目录安装技能。

安全说明： 技能可能会要求大模型直接编写 HTML，并根据 Jellyfish API 返回的数据构建内容。由于 HTML 是生成的，而非固定的，使用技能就意味着信任 Jellyfish 返回的数据和模型据此构建的 HTML 都可以安全呈现。如果这种信任并无依据，技能可能会生成危险内容，包括用户无意中要求的 HTML 或 JavaScript。技能完全可选，且需要单独安装，因此不愿承担这一风险的用户可以不安装。完整说明请参阅 SECURITY.md。

仪表板

• jellyfish-custom-dashboards — 根据 Jellyfish 工程分析数据生成带有品牌标识的 HTML 仪表板。目前支持工程投入报告。

许可证

此代码基于 MIT 许可证分发。请参阅 LICENSE。