mcp-test

GitHub MCP Server implementation and testing repository

0 starsServers & Infrastructure Updated May 20, 2025

Documentation

GitHub MCP Server

このリポジトリは Model Context Protocol (MCP) サーバーの実装と使用方法のテストを行うためのものです。

概要

Model Context Protocol (MCP) は、大規模言語モデル (LLM) とクライアントアプリケーション間の通信を標準化するためのプロトコルです。このプロトコルを使用することで、エージェントは外部ツールやクライアントアプリケーションと効果的に連携することができます。

GitHub MCPサーバーは、GitHub APIと連携し、リポジトリ操作、コード検索、イシュー管理などの機能をLLMエージェントに提供します。

特徴

リポジトリ操作: リポジトリの作成、ファイルの追加・編集、ブランチ管理
コード検索: GitHub上のコードを検索
イシュー/PR管理: イシューやプルリクエストの作成、更新、コメント
認証管理: GitHub APIとの安全な認証

必要条件

Node.js (v16.0.0以上)
npm または yarn
GitHub アカウントと個人アクセストークン (PAT)

インストール方法

bash

# リポジトリをクローン
git clone https://github.com/tomo-cps/mcp-test.git
cd mcp-test

# 依存パッケージのインストール
npm install
# または
yarn install

設定

1. `.env` ファイルを作成し、以下の環境変数を設定:

code

GITHUB_TOKEN=your_github_personal_access_token
PORT=3000

2. GitHub 個人アクセストークンを取得する方法:

サーバーの起動

bash

# 開発モード
npm run dev
# または
yarn dev

# 本番モード
npm start
# または
yarn start

デフォルトでは、サーバーは `http://localhost:3000` で実行されます。

API エンドポイント

このMCPサーバーは以下の主要なエンドポイントを提供します:

`/mcp/describe`: 利用可能な機能とパラメータを記述
`/mcp/execute`: 指定されたコマンドを実行
`/mcp/state`: 現在の状態を取得または更新

使用例

1. リポジトリ情報の取得

javascript

// クライアント側のコード例
const response = await fetch('http://localhost:3000/mcp/execute', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    command: 'get_repository',
    params: {
      owner: 'octocat',
      repo: 'hello-world'
    }
  })
});

const data = await response.json();
console.log(data);

2. イシューの作成

javascript

// クライアント側のコード例
const response = await fetch('http://localhost:3000/mcp/execute', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    command: 'create_issue',
    params: {
      owner: 'your-username',
      repo: 'your-repo',
      title: 'バグ: ログイン画面で問題が発生',
      body: '詳細な説明をここに記述します...',
      labels: ['bug', 'priority:high']
    }
  })
});

const data = await response.json();
console.log(data);