OSSInsight MCP Server

OSSInsight MCP サーバー

OSSInsight.io をベースとする MCP サーバーです。GitHub の個人、組織、リポジトリのデータ分析に加え、オープンソースエコシステムを深く分析できます。

機能

• リポジトリ分析：スター数の推移、コントリビューターの活動、コードコミットなど、GitHub リポジトリに関する包括的なデータを取得します
• 開発者分析：開発者の貢献パターン、活動履歴、影響力を把握できます
• 組織分析：メンバー、リポジトリ、全体的な活動など、GitHub 組織を幅広い視点から確認できます
• プロジェクト比較：2 つのリポジトリの主要な指標を並べて比較し、相違点や類似点を見つけられます
• プロジェクトコレクション：オープンソースデータベースや AI ツールなど、厳選されたプロジェクトコレクションを閲覧、探索できます
• 自然言語クエリ：OSSInsight のチャットインターフェースを利用して、GitHub のデータについて質問できます

ツール

1. get_repo_analysis

   • GitHub リポジトリの詳細な分析を取得します
   • 入力：
     • owner_repo（string）：'owner/repo' 形式のリポジトリ名
     • time_period（任意の string）：分析対象の期間
   • 戻り値：API とウェブページの両方から取得したリポジトリ分析データと、OSSInsight ページへのリンク

2. get_developer_analysis

   • GitHub 開発者の詳細な分析を取得します
   • 入力：
     • username（string）：GitHub ユーザー名
   • 戻り値：API とウェブページの両方から取得した開発者データと、OSSInsight ページへのリンク

3. get_collection

   • 特定のリポジトリコレクションに関する情報を取得します
   • 入力：
     • collection_id（string）：コレクション ID。例：'open-source-database'
   • 戻り値：コレクションデータと OSSInsight のコレクションページへのリンク

4. list_collections

   • 利用可能なすべてのリポジトリコレクションを一覧表示します
   • 入力：
     • page（任意の number）：ページ番号。1 から始まります
     • per_page（任意の number）：1 ページあたりの結果数。デフォルトは 20 です
   • 戻り値：コレクションの一覧と、OSSInsight でコレクションを閲覧するためのリンク

5. natural_language_query

   • OSSInsight の自然言語クエリインターフェースに直接アクセスします
   • 入力：
     • query（string）：自然言語によるクエリ。例：「2023 年に最もスターを獲得したリポジトリはどれですか？」
   • 戻り値：クエリが入力された状態の OSSInsight チャットインターフェースへの直接リンク

実装の詳細

この MCP サーバーでは、データ取得に 2 つの方法を併用しています。

1. OSSInsight 公開 API（v1）- https://api.ossinsight.io/v1/ エンドポイントに直接 API リクエストを送信します
2. ウェブページのスクレイピング - API の利用が制限されている場合や利用できない場合は、OSSInsight のウェブページをスクレイピングします

この方法により、公開 API のレート制限（IP あたり 1 時間に 600 リクエスト）を守りながら、OSSInsight の機能を最大限に活用できます。

セットアップ

使用方法の設定

Docker

{
  "mcpServers": { 
    "ossinsight": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/ossinsight"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "ossinsight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ossinsight"
      ]
    }
  }
}

ビルド

Docker ビルド：

docker build -t mcp/ossinsight -f Dockerfile .

使用例

リポジトリ分析の取得

// Get analysis data for the VSCode repository
{
  "owner_repo": "microsoft/vscode"
}

2 つのリポジトリの比較

// Compare React and Vue
{
  "repo1": "facebook/react",
  "repo2": "vuejs/vue"
}

自然言語クエリ

// Get a link to query data using natural language
{
  "query": "Which database projects gained the most stars in 2023?"
}

ライセンス

この MCP サーバーは MIT License のもとでライセンスされています。MIT License の利用規約に従う限り、このソフトウェアは自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリの LICENSE ファイルをご覧ください。

---

OSSInsight MCP サーバー

OSSInsight.io をベースとする MCP サーバーです。GitHub の個人、組織、リポジトリのデータ分析に加え、オープンソースエコシステムを深く分析できます。

機能

• リポジトリ分析：GitHub リポジトリに関する包括的なデータを取得します。スター数の推移、コントリビューターの活動、コードのコミットなどが含まれます
• 開発者分析：開発者のコントリビューションパターン、活動履歴、影響力を把握します
• 組織分析：メンバー、リポジトリ、全体的な活動など、GitHub 組織の全体像を確認します
• プロジェクトの比較：2 つのリポジトリの主要な指標を並べて比較し、違いや共通点を見つけます
• プロジェクトコレクション：オープンソースデータベースや AI ツールなど、厳選されたプロジェクトコレクションを閲覧して探索します
• 自然言語クエリ：OSSInsight のチャットインターフェースを利用して、GitHub データについて自然言語で質問します

ツール

1. get_repo_analysis

   • GitHub リポジトリの詳細な分析を取得します
   • 入力:
     • owner_repo (文字列): リポジトリ名。形式は 'owner/repo' です
     • time_period (任意の文字列): 分析対象の期間
   • 戻り値: API とウェブページから取得したリポジトリ分析データ、および OSSInsight ページへのリンク

2. get_developer_analysis

   • GitHub 開発者の詳細な分析を取得します
   • 入力:
     • username (文字列): GitHub ユーザー名
   • 戻り値: API とウェブページから取得した開発者データ、および OSSInsight ページへのリンク

3. get_collection

   • 特定のコレクションに関する情報とリポジトリ一覧を取得します
   • 入力:
     • collection_id (文字列): コレクション ID。例: 'open-source-database'
   • 戻り値: コレクションデータ、および OSSInsight のコレクションページへのリンク

4. list_collections

   • 利用可能なすべてのリポジトリコレクションを一覧表示します
   • 入力:
     • page (任意の数値): ページ番号。1 から始まります
     • per_page (任意の数値): 1 ページあたりの結果数。デフォルトは 20 です
   • 戻り値: コレクション一覧、および OSSInsight のコレクション閲覧ページへのリンク

5. natural_language_query

   • OSSInsight の自然言語クエリインターフェースに直接アクセスします
   • 入力:
     • query (文字列): 自然言語クエリ。例: 'Which repositories gained the most stars in 2023?'
   • 戻り値: クエリが事前入力された OSSInsight チャットインターフェースへの直接リンク

実装の詳細

この MCP サーバーは、データ取得に二重の方法を使用します。

1. OSSInsight 公開 API (v1) - https://api.ossinsight.io/v1/ エンドポイントを直接呼び出します
2. ウェブスクレイピング - API が制限されている場合や利用できない場合は、OSSInsight のウェブページのスクレイピングにフォールバックします

この方法により、公開 API のレート制限（IP ごとに 1 時間あたり 600 リクエスト）を尊重しながら、OSSInsight の機能を最大限に利用できます。

セットアップ

設定を使用する

Docker

{
  "mcpServers": { 
    "ossinsight": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/ossinsight"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "ossinsight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ossinsight"
      ]
    }
  }
}

ビルド

Docker ビルド:

docker build -t mcp/ossinsight -f src/ossinsight/Dockerfile .

使用例

リポジトリ分析の取得

// 获取 VSCode 仓库的分析数据
{
  "owner_repo": "microsoft/vscode"
}

2 つのリポジトリの比較

// 比较 React 和 Vue
{
  "repo1": "facebook/react",
  "repo2": "vuejs/vue"
}

自然言語クエリ

// 获取使用自然语言查询数据的链接
{
  "query": "哪些数据库项目在 2023 年获得了最多的星标？"
}

ライセンス

この MCP サーバーは MIT ライセンスに基づいています。つまり、MIT ライセンスの条項および条件に従う限り、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。