Forgejo MCP

🚀 Forgejo MCP サーバー

Forgejo MCP サーバー は、Forgejo をモデルコンテキストプロトコル（MCP）システムに接続するための統合プラグインです。これにより、MCP 互換のチャットインターフェイスを通じてコマンドを実行し、リポジトリを管理することが可能になります。

🚧 インストール

📥 公式バイナリファイルのダウンロード

公式バイナリファイルは こちら からダウンロードできます。

🔧 ソースコードからのビルド

Git でリポジトリをクローンすることでソースコードをダウンロードできます：

git clone https://forgejo.org/forgejo/forgejo-mcp.git

ビルドする前に、以下のツールがインストールされていることを確認してください：

• make
• Golang（Go 1.24 以上の使用を推奨）

次に、以下のコマンドを実行します：

make build

📁 PATH に追加

ビルドが完了したら、バイナリファイル forgejo-mcp をシステムの PATH に含まれるディレクトリにコピーします。例えば：

cp forgejo-mcp /usr/local/bin/

🚀 使用方法

この例は Cursor 用ですが、VSCode でもプラグインを使用できます。 Forgejo の MCP サーバーを設定するには、以下の内容を MCP 設定ファイルに追加します：

• stdio モード

{
  "mcpServers": {
    "forgejo": {
      "command": "forgejo-mcp",
      "args": [
        "-t", "stdio",
        "--host", "https://forgejo.org"
        // "--token", "<あなたの個人アクセストークン>"
      ],
      "env": {
        // "GITEA_HOST": "https://forgejo.org",
        "GITEA_ACCESS_TOKEN": "<あなたの個人アクセストークン>"
      }
    }
  }
}

• sse モード

{
  "mcpServers": {
    "forgejo": {
      "url": "http://localhost:8080/sse"
    }
  }
}

⚠️ 重要な注意事項 Forgejo のホストとアクセストークンは、コマンドライン引数または環境変数で指定できます。コマンドライン引数の優先順位が最も高いです。

設定が完了したら、MCP 互換のチャットボックスに以下を入力してみてください：

列出我所有的仓库

✅ 利用可能なツール

Forgejo MCP サーバーは以下のツールをサポートしています：

🚈 デバッグ

デバッグモードを有効にするには、forgejo-mcp を実行する際に -d または --debug フラグを追加します：

forgejo-mcp -d

これにより、サーバーは詳細なデバッグ情報を出力し、問題のトラブルシューティングに役立ちます。