Skip to main content
Glama
papunoko

Redmine MCP Server for Cline

by papunoko

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

インストール

  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_HOSTREDMINE_API_KEYが正しく設定されていることを確認してください。また、お使いのコンピューターから Redmine インスタンスにアクセスできることを確認してください。

  • **サーバーログを確認する:**問題が発生した場合は、VS Codeターミナルでサーバーの出力にエラーメッセージがないか確認してください。サーバーはコンソールにエラーを記録します。

Available Tools

1 tool
create_issueC

Create a new Redmine issue

ParametersJSON Schema
NameRequiredDescriptionDefault
project_idYesProject ID
subjectYesIssue subject
descriptionYesIssue description

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

B3.1/5.0
Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness2/5

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

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    A 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.
    78
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol server that enables Claude Code to directly interact with Redmine project management systems, supporting issue management, project operations, and search features.
    22
    9
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI coding agents to interact with Redmine projects, issues, time tracking, and members through natural language via the Model Context Protocol.

Latest Blog Posts

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