Cline 用 Redmine MCP サーバー

これは、Redmine と統合されたカスタム MCP (Model Context Protocol) サーバーであり、Cline VS Code 拡張機能を通じて Redmine プロジェクトや問題を操作できるようになります。

前提条件

**Node.js:**システムに Node.js (バージョン 18 以降) がインストールされている必要があります。
Redmine インスタンス: REST API が有効になっている実行中の Redmine インスタンスが必要です。
Redmine APIキー： RedmineユーザーアカウントのAPIキーが必要です。これはRedmineアカウント設定（通常は「マイアカウント」→「APIアクセスキー」）で確認できます。
Cline: Cline VS Code 拡張機能をインストールして構成する必要があります。

リポジトリをクローンします。

git clone https://github.com/ilask/Redmine-MCP.git
cd Redmine-MCP

**環境変数を設定する:**プロジェクトディレクトリのルートに.envファイルを作成し、次のコードを追加します。プレースホルダーは実際の Redmine ホスト名と API キーに置き換えます。
```
REDMINE_HOST=your-redmine-host.com
REDMINE_API_KEY=your-redmine-api-key
```
重要: .envファイルをバージョン管理にコミットしないでください。機密情報が含まれています。このリポジトリに含まれる.gitignoreファイルにより、コミットがブロックされるはずです。

Cline 設定を開く: VS Code で Cline 拡張機能を開き、MCP サーバータブに移動します。
MCP 設定の編集: 「MCP 設定の編集」をクリックして、 cline_mcp_settings.jsonファイルを開きます。
サーバーを追加します。mcpServersオブジェクトに次のエントリを追加し、 argsパスをシステム上のserver.jsファイルへの絶対パスmcpServers置き換えます。
```
{
  "mcpServers": {
    "redmine-server": {
      "command": "node",
      "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
```
重要: Windows のパスでは必ず二重のバックスラッシュ ( \\ ) を使用してください。
保存: cline_mcp_settings.jsonファイルを保存します。Cline は自動的に変更を検出し、サーバーを起動します。

**redmine://projects/{project_id} :**このリソースはRedmineプロジェクトを表します。 {project_id} Redmineインスタンス内の実際のプロジェクトIDに置き換えてください。Clineのaccess_mcp_resourceツールを使用してプロジェクトの詳細を取得できます。例:
```
<access_mcp_resource>
<server_name>redmine-server</server_name>
<uri>redmine://projects/123</uri>
</access_mcp_resource>
```

（ 123有効なプロジェクトIDに置き換えてください）。これにより、プロジェクトの詳細がJSON形式で返されます。

**create_issue :**このツールを使うと、Redmine に新しい課題を作成できます。以下のパラメータを取ります。
- project_id (文字列、必須): 問題を作成するプロジェクトの ID。
- subject (文字列、必須): 問題の件名。
- description (文字列、必須): 問題の説明。
このツールを呼び出すには、Cline のuse_mcp_toolツールを使用します。例:
```
<use_mcp_tool>
<server_name>redmine-server</server_name>
<tool_name>create_issue</tool_name>
<arguments>
{
  "project_id": "456",
  "subject": "My New Issue",
  "description": "This is a test issue created via Cline."
}
</arguments>
</use_mcp_tool>
```
（ 456有効なプロジェクト ID に置き換えてください）。これにより、指定されたプロジェクトに新しい問題が作成され、問題の詳細が JSON として返されます。

接続が閉じられました： "MCP error -1: Connection closed" のようなエラーが表示された場合は、環境変数REDMINE_HOSTとREDMINE_API_KEYが正しく設定されていることを確認してください。また、お使いのコンピューターから Redmine インスタンスにアクセスできることを確認してください。
**サーバーログを確認する：**問題が発生した場合は、VS Codeターミナルでサーバーの出力にエラーメッセージがないか確認してください。サーバーはコンソールにエラーを記録します。