Forgejo MCP環境設定ガイドのバックアップ(No.1)

バックアップ一覧
差分を表示
現在との差分を表示
ソースを表示
Forgejo MCP環境設定ガイドへ行く。
- 1 (2025-06-17 (火) 03:29:18)

目次 †

#context

Forgejo MCP環境設定ガイド：Claude DesktopでAIエージェントを強化しよう！ †

はじめに †

このガイドでは、Claude DesktopにForgejo MCPサーバーを接続する方法を詳しく説明します。公式サイトにはWindows用の設定が書いていないので、実際に試行錯誤して成功した方法をまとめました。AIエージェントの可能性を大幅に広げる、とても有用な設定です！

↑

Forgejoって何？なぜGitHub?じゃダメなの？ †

↑

Forgejoとは †

Forgejoは、GitHub?やGitLabのようなGitホスティングサービスのオープンソース版です。自分のサーバーで動かすことができる「セルフホスト型」のGitプラットフォームです。

↑

なぜForgejoを使うの？ †

答え：AIエージェントを思いっきり追加できるから！

GitHub?の制限: GitHub?は商用サービスなので、API制限や利用規約があります
Forgejoの自由度: 自分のサーバーなので、好きなだけAIエージェントを接続できます
プライベート: 機密性の高いプロジェクトも安心して管理できます
カスタマイズ: 必要に応じて機能を追加・変更できます

↑

AIエージェントの長期記憶として活用 †

Forgejoを使うことで、Claude Desktopがあなたのプロジェクトを「覚えて」おけるようになります：

プロジェクトの進捗管理: AIがイシューやタスクを追跡
コード履歴の把握: 過去の変更を理解して、より良い提案ができる
継続的な改善: プロジェクトの成長をAIと一緒に見守れる

↑

必要なもの †

Windows PC
Claude Desktop（インストール済み）
Forgejoサーバー（ローカルまたはリモート）
Git Bash（推奨）

↑

ステップ1: Forgejo MCPサーバーの入手 †

↑

GitHub?からクローン †

git clone https://github.com/goern/forgejo-mcp.git

↑

プロジェクトフォルダに移動 †

cd forgejo-mcp

↑

ステップ2: ビルド †

↑

ビルド実行 †

make build

このコマンドでforgejo-mcpという実行ファイルが作成されます。

↑

ステップ3: Windows用の調整（重要！） †

ここがポイント！Windows CMDでは拡張子のないファイルを実行できないので、ファイル名を変更する必要があります。

↑

ファイル名変更 †

copy forgejo-mcp forgejo-mcp.exe

↑

動作確認 †

.\forgejo-mcp.exe --help

以下のような出力が表示されれば成功です：

Usage of .\forgejo-mcp.exe:
  -d    debug mode (default true)
  -debug
        debug mode (default true)
  -host string
        Forgejo host (default "https://forgejo.org")
  -port int
        sse port (default 8080)
  -t string
        Transport type (stdio or sse) (default "stdio")
  -token string
        Your personal access token
  -transport string
        Transport type (stdio or sse) (default "stdio")

↑

環境変数の設定（推奨） †

forgejo-mcp.exeのパスをWindows環境変数PATHに追加しておくと、フルパスを指定しなくても実行できるようになります。

Windowsキー + Rで「ファイル名を指定して実行」を開く
sysdm.cplと入力してEnter
「詳細設定」タブ → 「環境変数」
システム環境変数の「Path」を選択 → 「編集」
forgejo-mcp.exeがあるフォルダのパスを追加

↑

ステップ4: Claude Desktop設定 †

↑

設定ファイルの場所 †

Claude Desktopの設定ファイルを開きます：

%APPDATA%\Claude\claude_desktop_config.json

↑

設定内容の追加 †

以下の設定を追加します：

{
  "mcpServers": {
    "forgejo": {
      "command": "forgejo-mcp.exe",
      "args": [
        "-t", "stdio",
        "--host", "http://localhost:3000"
      ],
      "env": {
        "GITEA_HOST": "http://localhost:3000",
        "GITEA_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

↑

設定内容の説明 †

&color(blue){command}: 実行ファイル名（環境変数に追加した場合はファイル名のみでOK）
&color(blue){args}:
- &color(green){-t stdio}: 標準入出力での通信を指定
- &color(green){--host}: ForgejoサーバーのURL
&color(blue){env}:
- &color(green){GITEA_HOST}: Forgejoサーバーのホスト
- &color(green){GITEA_ACCESS_TOKEN}: アクセストークン（Forgejoで生成）

↑