Forgejo MCP

🚀 Gitea/Forgejo MCP Server

AIをコードリポジトリ管理のアシスタントに変える

Model Context Protocol (MCP)サーバーで、Claude、Gemini、CopilotなどのAIアシスタントを通じてGitea/Forgejoリポジトリを管理できます。

🚀 なぜForgejo MCP Serverを使うのか？

もしあなたが以下のことをしたい場合：

• スマートな進捗追跡：AIにプロジェクトの進捗を追跡させ、ボトルネックを分析させる
• 自動的なイシュー分類：内容に基づいて自動的にイシューのラベルを付け、マイルストーンを設定する
• 優先順位の並べ替え：AIにイシューの内容を分析させ、タスクの優先順位を付ける
• コードレビュー支援：プルリクエストでAIの提案と洞察を得る
• プロジェクトドキュメントの整理：自動的にWikiドキュメントとリリースノートを整理する

それならこのツールはあなたにぴったりです！

✨ サポートされる機能

イシュー管理

• イシューの作成、編集、表示
• ラベルの追加、削除、置換
• イシューのコメントと添付ファイルの管理
• イシューの依存関係の設定

プロジェクト組織化

• ラベルの管理（作成、編集、削除）
• マイルストーンの管理（作成、編集、削除）
• リポジトリの検索と一覧表示

リリース管理

• バージョンリリースの管理
• リリース添付ファイルの管理

その他の機能

• プルリクエストの表示
• Wikiページの管理
• Forgejo/Gitea Actionsタスクの表示

📦 インストール

方法1：Dockerを使用する（おすすめ）

STDIOモードの場合は、使用方法セクションにスキップできます。

SSE/Streamable HTTPモードの場合は、MCPクライアントを設定する前にforgejo-mcpをサーバーとして実行する必要があります。

docker run -p 8080:8080 -e FORGEJOMCP_TOKEN="my-forgejo-api-token" ronmi/forgejo-mcp http --address :8080 --server https://git.example.com

方法2：ソースからインストール

go install github.com/raohwork/forgejo-mcp@latest

方法3：事前にコンパイルされたバイナリをダウンロード

リリースページから、あなたのオペレーティングシステムに適したバージョンをダウンロードします。

💻 使用例

このツールは、ローカル統合用のstdioモードとリモートアクセス用のhttpモードの2つの主要な動作モードを提供します。

実際にMCPクライアントを設定する前に、Forgejo/Giteaサーバーでアクセストークンを作成する必要があります。

1. Forgejo/Giteaインスタンスにログインする
2. 設定 → アプリケーション → アクセストークンに移動する
3. 新しいトークンを生成するをクリックする
4. 適切な権限スコープを選択する（少なくともrepositoryとissueの書き込み権限を推奨）
5. 生成されたトークンをコピーする

💡 使用アドバイス

セキュリティ上の理由から、設定でトークンを直接使用する代わりに環境変数を設定することを検討してください。

export FORGEJOMCP_SERVER="https://your-forgejo-instance.com"
export FORGEJOMCP_TOKEN="your_access_token"

基本的な使用法

STDIOモード（ローカルクライアント用）

これは、Claude DesktopやGemini CLIなどのローカルAIアシスタントクライアントと統合するためのおすすめのモードです。標準入出力を使用して直接通信します。

AIクライアントの設定

Dockerを使用する場合：

{
  "mcpServers": {
    "forgejo": {
      "command": "docker",
      "args": [
        "--rm",
        "ronmi/forgejo-mcp",
        "stdio",
        "--server", "https://your-forgejo-instance.com",
        "--token", "your_access_token"
      ]
    }
  }
}

ソースからインストールまたは事前にビルドされたバイナリを使用する場合：

{
  "mcpServers": {
    "forgejo": {
      "command": "/path/to/forgejo-mcp",
      "args": [
        "stdio",
        "--server", "https://your-forgejo-instance.com",
        "--token", "your_access_token"
      ]
    }
  }
}

セキュリティのベストプラクティスについては、セキュリティ推奨事項セクションを参照してください。

高度な使用法

HTTPサーバーモード（リモートアクセス用）

このモードはWebサーバーを起動し、HTTPを介してリモートクライアントが接続できるようにします。Webベースのサービスや複数のユーザー用の中央ゲートウェイを設定するのに最適です。

サーバーを起動するには、次のコマンドを実行します。

# ローカルバイナリを使用する場合
/path/to/forgejo-mcp http --address :8080 --server https://your-forgejo-instance.com

# Dockerを使用する場合
docker run -p 8080:8080 -d --rm ronmi/forgejo-mcp http --address :8080 --server https://your-forgejo-instance.com

サーバーは2つの動作モードをサポートしています。

• シングルユーザーモード：起動時に--token（または環境変数FORGEJOMCP_TOKEN）を指定すると、すべての操作でそのトークンが使用されます。

  forgejo-mcp http --address :8080 --server https://git.example.com --token your_token
  

• マルチユーザーモード：トークンが指定されていない場合、サーバーはクライアントが各リクエストにAuthorization: Bearer <token>ヘッダーを送信することを要求し、複数のユーザーを安全にサポートします。

クライアントの設定

HTTPを介してリモートMCPサーバーに接続をサポートするクライアントの場合、次のような設定を追加できます。この例は、マルチユーザーモードで実行されているサーバーに接続する方法を示しています。

{
  "mcpServers": {
    "forgejo-remote": {
      "type": "sse",
      "url": "http://localhost:8080/sse",
      "headers": {
        "Authorization": "Bearer your_token"
      }
    }
  }
}

またはhttpタイプ（Streamable HTTPの場合は、URLで異なるパスを使用）

{
  "mcpServers": {
    "forgejo-remote": {
      "type": "http",
      "url": "http://localhost:8080/",
      "headers": {
        "Authorization": "Bearer your_token"
      }
    }
  }
}

シングルユーザーモードのサーバーに接続する場合は、headersフィールドを省略できます。

🛡️ セキュリティ推奨事項

1. 環境変数を使用する：FORGEJOMCP_SERVERとFORGEJOMCP_TOKENを設定し、設定から--serverと--tokenを削除する
2. トークンの権限を制限する：必要な権限スコープのみを付与する
3. 定期的にトークンを更新する：アクセストークンを定期的に更新する

📋 使用例

設定後、AIアシスタントで自然言語を使用してリポジトリを管理できます。

"Show me critical bug reports of this repo on my gitea server"

"According to our discussion above, create a detailed issue about this bug, then leave a comment on the issue to describe how we will fix it."

"Give me a report about current milestone. Recent progression in particular."

"Analyze recent pull requests and tell me which ones need priority review"

🤝 サポートと貢献

• バグ報告：GitHub Issues
• コードの貢献：プルリクエストを歓迎します！

📄 ライセンス

このプロジェクトはMozilla Public License 2.0の下でライセンスされています。

AIをコードリポジトリ管理のパートナーにしましょう！ 🚀