Redmine MCP Server for Cline

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 拡張機能をインストールして構成する必要があります。

インストール

1. リポジトリをクローンします。
   git clone https://github.com/ilask/Redmine-MCP.git cd Redmine-MCP
2. 依存関係をインストールします:
   npm install

構成

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

クラインに追加

1. Cline 設定を開く: VS Code で Cline 拡張機能を開き、MCP サーバー タブに移動します。
2. MCP 設定の編集: 「MCP 設定の編集」をクリックして、 cline_mcp_settings.jsonファイルを開きます。
3. サーバーを追加します。mcpServersオブジェクトに次のエントリを追加し、 argsパスをシステム上のserver.jsファイルへの絶対パスmcpServers置き換えます。
   { "mcpServers": { "redmine-server": { "command": "node", "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"], "disabled": false, "autoApprove": [] } } }
   重要: Windows のパスでは必ず二重のバックスラッシュ ( \\ ) を使用してください。
4. 保存: 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ターミナルでサーバーの出力にエラーメッセージがないか確認してください。サーバーはコンソールにエラーを記録します。