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

• 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 は任意のエージェントスキルと連携します。スキルもチャットの会話中に呼び出せますが、MCP には同梱されておらず、別途インストールする必要があります。Claude Desktop にスキルをインストールするには、最新リリースから .skill ファイルをダウンロードし、ダブルクリックしてインストールします。他のホストアプリケーションの場合は、skills/ ディレクトリからスキルを直接インストールしてください。

セキュリティに関する注意： スキルは、Jellyfish API から返されたデータを基に、LLM に HTML を直接作成するよう求める場合があります。HTML は固定されたものではなく生成されるため、スキルを使用するということは、Jellyfish が返すデータとモデルが作成する HTML の両方を安全に表示できると信頼することを意味します。その信頼が誤っている場合、スキルはユーザーが意図していない HTML や JavaScript など、危険な出力を生成する可能性があります。スキルは完全に任意であり、別途インストールするため、この前提を受け入れたくない場合はインストールせずにおくことができます。詳細については、SECURITY.md を参照してください。

ダッシュボード

• jellyfish-custom-dashboards — Jellyfish のエンジニアリング分析から、ブランドに合わせた HTML ダッシュボードを生成します。現在はエンジニアリング投資レポートに対応しています。

ライセンス

このコードは MIT ライセンスの下で配布されています。LICENSE を参照してください。