https://github.com/yuki-koma2/my-mcp-servers
this is mcp servers in local
https://github.com/yuki-koma2/my-mcp-servers
Last synced: 2 months ago
JSON representation
this is mcp servers in local
- Host: GitHub
- URL: https://github.com/yuki-koma2/my-mcp-servers
- Owner: yuki-koma2
- Created: 2025-03-13T03:15:20.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-03-27T09:24:50.000Z (8 months ago)
- Last Synced: 2025-03-27T09:43:12.064Z (8 months ago)
- Language: Python
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **my-mcp-servers** - this is mcp servers in local `python` `mcp` `server` `pip install git+https://github.com/yuki-koma2/my-mcp-servers` (🤖 AI/ML)
- awesome-mcp-servers - **my-mcp-servers** - this is mcp servers in local `python` `mcp` `server` `pip install git+https://github.com/yuki-koma2/my-mcp-servers` (AI/ML)
README
# Dockerized GitHub MCP Server
GitHubのAPIと連携し、リポジトリのファイル操作、リポジトリ管理、検索機能などを提供するModel Context Protocol（MCP）サーバーをDockerコンテナとして提供します。
## 機能
- **自動ブランチ作成**: ファイル作成/更新時やpush時に、存在しないブランチを自動的に作成
- **包括的なエラーハンドリング**: 一般的な問題に対する明確なエラーメッセージを提供
- **Gitヒストリー保持**: 操作は強制pushを使わず適切なGitヒストリーを維持
- **バッチ操作**: 単一ファイルと複数ファイルの両方の操作をサポート
- **高度な検索**: コード、イシュー/PR、ユーザーの検索をサポート
## セットアップ
### 1. GitHub Personal Access Tokenの準備
1. [GitHub Personal Access Token](https://docs.github.com/ja/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)を作成します
- GitHubの設定 > 開発者設定 > Personal access tokenに移動
- このトークンがアクセスできるリポジトリを選択（Public、All、または特定のリポジトリ）
- `repo`スコープ（「プライベートリポジトリの完全な制御」）を選択
- または、公開リポジトリのみを操作する場合は`public_repo`スコープのみを選択
- 生成されたトークンをコピー
2. `.env`ファイルにトークンを設定:
```
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here
```
### 2. Dockerによるビルドと起動
#### ビルド手順
```bash
# Dockerイメージのビルド
docker build -t mcp/github -f src/github/Dockerfile .
```
#### 起動手順（docker runの場合）
```bash
docker run -it --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PERSONAL_ACCESS_TOKEN -p 5000:5000 mcp/github
```
#### 複数コンテナ起動（docker-compose）
```bash
# .envファイルを作成してトークンを設定
cp .env.template .env
# 環境変数を編集
nano .env
# 起動
docker-compose up -d
```
これにより、2つの異なるポート（5002と5003）でGitHub MCPサーバーが起動します。
コンテナはttyモードで起動し、stdioインターフェースを通じて通信を待機します。
### 3. Cursorでの使用方法
MCPサーバーは標準入出力（stdio）を介して通信するように設計されています。Cursorと連携するには、`claude_desktop_config.json`に以下の設定を追加してください：
```json
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"mcp/github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
}
}
}
```
この設定により、Cursorが必要なときにだけMCPサーバーを起動し、処理が完了すると自動的に終了します。
## 使用方法
MCPサーバーは、ツール名とその入力パラメータを含むメッセージ形式でリクエストを受け付けます。
### リクエスト例（/respond エンドポイント）
#### ファイルの作成または更新
```bash
curl -X POST http://localhost:5002/respond \
-H "Content-Type: application/json" \
-d '{
"messages": [
{
"role": "user",
"content": {
"tool_name": "create_or_update_file",
"input": {
"owner": "your-username",
"repo": "your-repo",
"path": "example.txt",
"content": "Hello, world!",
"message": "Add example file",
"branch": "main"
}
}
}
]
}'
```
#### リポジトリ検索
```bash
curl -X POST http://localhost:5002/respond \
-H "Content-Type: application/json" \
-d '{
"messages": [
{
"role": "user",
"content": {
"tool_name": "search_repositories",
"input": {
"query": "modelcontextprotocol"
}
}
}
]
}'
```
#### ファイル内容取得
```bash
curl -X POST http://localhost:5002/respond \
-H "Content-Type: application/json" \
-d '{
"messages": [
{
"role": "user",
"content": {
"tool_name": "get_file_contents",
"input": {
"owner": "octocat",
"repo": "Hello-World",
"path": "README.md"
}
}
}
]
}'
```
## サポートしているツール
GitHub MCPサーバーは以下の機能を提供します：
1. `create_or_update_file` - リポジトリに単一ファイルを作成/更新
2. `push_files` - 複数ファイルを一度のコミットでプッシュ
3. `search_repositories` - GitHubリポジトリを検索
4. `create_repository` - 新しいGitHubリポジトリを作成
5. `get_file_contents` - ファイルまたはディレクトリの内容を取得
6. `create_issue` - 新しいイシューを作成
7. `create_pull_request` - 新しいプルリクエストを作成
8. `fork_repository` - リポジトリをフォーク
9. `create_branch` - 新しいブランチを作成
10. `list_commits` - ブランチのコミット一覧を取得
11. `list_issues` - リポジトリのイシュー一覧を取得
12. `update_issue` - 既存のイシューを更新
13. `add_issue_comment` - イシューにコメントを追加
14. `search_code` - コードを検索
15. `search_issues` - イシューとプルリクエストを検索
16. `search_users` - GitHubユーザーを検索
17. `get_issue` - 特定のイシューの詳細を取得
18. `get_pull_request` - 特定のプルリクエストの詳細を取得
19. `list_pull_requests` - プルリクエスト一覧を取得
20. `create_pull_request_review` - プルリクエストのレビューを作成
21. `merge_pull_request` - プルリクエストをマージ
22. `get_pull_request_files` - プルリクエストの変更ファイル一覧を取得
23. `get_pull_request_status` - プルリクエストのステータスを取得
24. `update_pull_request_branch` - プルリクエストのブランチを更新
25. `get_pull_request_comments` - プルリクエストのコメントを取得
26. `get_pull_request_reviews` - プルリクエストのレビューを取得
詳細な各ツールの入力パラメータや使用方法については、[公式リポジトリのドキュメント](https://github.com/modelcontextprotocol/servers/tree/main/src/github)を参照してください。
## 注意事項
- **アクセストークン**: GitHub Personal Access Tokenは必要なスコープ（repoまたはpublic_repo）を持つものを使用してください。APIレート制限にも注意してください。
- **リクエスト形式**: MCPのプロトコルに準拠し、各メッセージはroleとcontent（中にtool_nameとinput）を含む必要があります。
- **stdioモード**: このMCPサーバーはHTTPサーバーではなく、標準入出力（stdio）を介して通信するよう設計されています。Cursorなどのツールから呼び出して使用するのが最適です。
## ライセンス
このプロジェクトは、元のMCP serverと同じMITライセンスのもとで提供されています。