github-stars

GitHub Stars MCP Serverは、Cloudflareを利用したMCPサーバーで、ユーザーのGitHubスター付きリポジトリを自然言語で検索・クエリできる機能を提供します。GitHub APIを使用してリポジトリのデータを取得し、READMEファイルを処理してCloudflare R2に保存し、効率的な検索のために埋め込みを生成します。AIエージェントとの統合が可能なAPIを提供します。

GitHubスター

77

ユーザー評価

未評価

お気に入り

0

閲覧数

20

フォーク

17

イシュー

0

インストール方法
難易度
中級
推定所要時間
10-20
必要な環境
Node.js (v22 recommended)
PNPM package manager
+2 more

インストール方法

インストール方法

前提条件

Node.js: v22推奨
PNPM: 最新版
GitHub Personal Access Token: repoスコープを持つもの
Cloudflareアカウント

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/ccbikai/github-stars.git
cd github-stars

2. 依存関係のインストール

bash
pnpm install

3. Cloudflare R2の設定

R2バケットを作成し、アクセス資格情報を設定。

4. GitHub Secretsの設定

GH_TOKEN: GitHubトークン
R2_ACCOUNT_ID: CloudflareアカウントID
R2_ACCESS_KEY_ID: R2アクセスキー
R2_SECRET_ACCESS_KEY: R2シークレットキー
R2_BUCKET: R2バケット名

5. Cloudflare AutoRAGの設定

CloudflareでAutoRAGインスタンスを作成し、AUTO_RAG_NAME環境変数を設定。

6. ローカル開発

bash
pnpm dev:stars
pnpm dev:mcp

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Node.jsのバージョンを確認し、依存関係を再インストールしてください。

設定方法

設定方法

基本設定

1リポジトリをクローンした後、Cloudflare R2を設定します。
2GitHub Secretsを設定します。
3Cloudflare AutoRAGを設定します。

環境変数

必要に応じて以下の環境変数を設定:
bash
export AUTO_RAG_NAME="your-auto-rag-name"

設定例

json
{
  "mcpServers": {
    "github-stars": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "GH_TOKEN": "your-gh-token",
        "R2_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

使用例

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します:

プログラムでの使用

javascript
// JavaScript例(Node.js)
const { MCPClient } = require('@modelcontextprotocol/client');

const client = new MCPClient();
await client.connect();

// ツールの実行
const result = await client.callTool('search_github_stars', {
  query: 'your search query'
});

console.log(result);

応用例

自動化スクリプト

bash
#!/bin/bash

バッチ処理の例

for file in *.txt; do mcp-tool process "$file" done

使用ケース

GitHubでスターを付けたリポジトリを自然言語で検索し、必要な情報を迅速に取得。
定期的に更新されるリポジトリ情報を活用して、プロジェクトの進捗を把握。
AIエージェントと統合し、ユーザーからの質問に対してリポジトリ情報を提供。
READMEファイルの内容を解析し、特定の技術スタックやライブラリに基づいてリポジトリをフィルタリング。

追加リソース