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
依存関係をインストールします:
npm install

**環境変数を設定する:**プロジェクトディレクトリのルートに.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ターミナルでサーバーの出力にエラーメッセージがないか確認してください。サーバーはコンソールにエラーを記録します。