MCP 服务器

Redmine MCP Server for Cline

通过 Cline VS Code 扩展启用与 Redmine 项目和问题的交互，支持通过模型上下文协议进行项目管理和问题创建。

开发者工具

版本控制

访问服务器

Tools

create_issue

Create a new Redmine issue

README

Redmine Cline 用 MCP 服务器

这是一个自定义的 MCP (模型上下文协议) 服务器，它与 Redmine 集成，允许你通过 Cline VS Code 扩展与你的 Redmine 项目和问题进行交互。

前提条件

Node.js: 你的系统需要安装 Node.js (18 或更新版本)。
Redmine 实例: 你需要一个运行中的 Redmine 实例，并且启用了 REST API。
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

打开 Cline 设置: 在 VS Code 中，打开 Cline 扩展并转到 MCP 服务器选项卡。
编辑 MCP 设置: 单击“编辑 MCP 设置”以打开 cline_mcp_settings.json 文件。

添加服务器: 将以下条目添加到 mcpServers 对象，将 args 路径替换为你系统上 server.js 文件的绝对路径：

{
  "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 终端中的服务器输出，以查找任何错误消息。服务器会将错误记录到控制台。