Forgejo Mcp

Gitea/Forgejo MCP Server

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

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

🚀 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 ベースのサービスや、複数のユーザー向けの集中ゲートウェイの構築に適しています。

次のコマンドを実行してサーバーを起動します。

# with local binary
/path/to/forgejo-mcp http --address :8080 --server https://your-forgejo-instance.com

# with 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 をコードリポジトリ管理のパートナーにしましょう！ 🚀