安全声明：本实现存在已知风险和固有限制。使用前请参见SECURITY.md。

[!重要] PromptGuard 并未随该服务器捆绑。我们建议在每天使用 jellyfish-mcp 之前先配置好它——请参见使用前的设置和 SECURITY.md PROMPTGUARD.md。

概述

一个用于从Jellyfish API中获取和分析数据的模型上下文协议服务器。该服务器允许主机（如Claude Desktop或Cursor）与你的Jellyfish实例交互，从而通过Jellyfish API进行关于工程指标、团队数据及其他信息的自然语言查询。

连接好Jellyfish MCP后，你可以对你的Jellyfish数据提出问题，例如：

• “2026年5月我们的公司指标是多少？”
• “你能拿到我组织的团队名单吗？”
• “过去一个月有哪些未关联的拉取请求？”

安装

完整安装指南请参见INSTALL.md。快速链接：

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

发展

Jellyfish MCP Server

Security Notice: There are known risks and inherent limitations in this implementation. Refer to SECURITY.md before using.

[!IMPORTANT] PromptGuard is not bundled with this server. We recommend configuring it before using jellyfish-mcp daily — see PROMPTGUARD.md for setup and SECURITY.md before using.

Overview

A Model Context Protocol server for retrieving and analyzing data from Jellyfish’s API. This server allows a host (e.g. Claude Desktop or Cursor) to interact with your Jellyfish instance, enabling natural language queries about your engineering metrics, team data, and other information available through the Jellyfish API.

Once you have the Jellyfish MCP connected, you can ask questions about your Jellyfish data, such as:

• “What were our company metrics in May 2026?”
• “Can you get a list of my organization’s teams?”
• “What are the unlinked pull requests for the last month?”

Install

See INSTALL.md for the full setup guide. Quick links:

• Claude Desktop — download the .mcpb extension, then double-click to install
• Claude Code, Cursor, VSCode — npx jellyfish-mcp-server@latest (recommended) or Docker

Develop

Want to modify the source or run from a local clone? See DEVELOPMENT.md.

Tools and Resources

The server provides several tools for interacting with the Jellyfish API. Each tool corresponds to a specific Jellyfish API endpoint and allows you to retrieve or search for data as described in the API.

General

• api_schema - Retrieves the complete API schema with all available API endpoints
• get_current_date - Returns today’s date in the specified timezone

AI Impact

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

Allocations

• 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

Delivery