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 拡張機能をインストールして構成する必要があります。
Related MCP server: Redmine MCP Server
インストール
リポジトリをクローンします。
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ターミナルでサーバーの出力にエラーメッセージがないか確認してください。サーバーはコンソールにエラーを記録します。
Available Tools
1 toolcreate_issueC
Create a new Redmine issue
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Project ID | |
| subject | Yes | Issue subject | |
| description | Yes | Issue description |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states this is a creation operation but doesn't mention permissions required, whether it's idempotent, error handling, or what happens on success (e.g., returns an issue ID). For a mutation tool with zero annotation coverage, this leaves critical behavioral aspects unspecified.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with no wasted words. It's appropriately sized for a simple creation tool and front-loads the essential information, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given this is a mutation tool with no annotations and no output schema, the description is insufficiently complete. It doesn't explain what the tool returns, error conditions, or behavioral nuances. The agent lacks critical information needed to use this tool effectively in real scenarios.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents all three parameters (project_id, subject, description) with basic descriptions. The tool description adds no additional parameter context beyond what's in the schema, resulting in the baseline score for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Create a new') and resource ('Redmine issue'), making the purpose immediately understandable. However, it doesn't differentiate from siblings (though none exist) or specify what constitutes a 'Redmine issue' beyond the basic concept, which prevents a perfect score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, prerequisites, or contextual constraints. The description merely restates the tool's function without offering any usage context, which is a significant gap for effective agent decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it to. The tool's purpose is clearly defined and distinct by default.
The single tool follows a clear verb_noun pattern (create_issue), which is consistent with itself. There are no other tools to create inconsistency, so the naming is perfectly predictable.
A single tool is too few for a server named 'Redmine MCP Server for Cline', which implies broader functionality for interacting with Redmine (e.g., an issue tracking system). This minimal set severely limits the server's utility and scope.
The tool surface is severely incomplete for Redmine interaction, as it only allows creating issues without any ability to read, update, delete, or search issues, or handle other Redmine entities like projects or users. This creates significant gaps for agent workflows.
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Share one project context across ChatGPT, Claude, Telegram and any MCP client.
Model Context Protocol server for todo.vu task management and time tracking.
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
An MCP server that provides access to Testiny projects, test cases and test runs
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server for interacting with Redmine using its REST API, enabling the management of tickets, projects, and user data through integration with LLMs.78MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables Claude Code to directly interact with Redmine project management systems, supporting issue management, project operations, and search features.229MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI coding agents to interact with Redmine projects, issues, time tracking, and members through natural language via the Model Context Protocol.
- AlicenseAqualityDmaintenanceEnables Cursor IDE to directly interact with OpenProject through the Model Context Protocol, supporting CRUD operations on projects and work packages.915MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/papunoko/Redmine-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server