Redmine + Figma MCP Server

一个集成了 Redmine 需求管理和 Figma 设计分析的 MCP (Model Context Protocol) Server。

功能

• redmine_get_issue: 获取 Redmine 需求的详细信息
• figma_get_file: 获取 Figma 设计文件信息
• figma_analyze_design: 分析 Figma 设计文档结构
• redmine_figma_analyze: 综合分析需求和设计
• extract_figma_key: 从 Figma URL 提取文件 key
• generate_figma_design: 根据需求生成 Figma 设计结构
• generate_vue_frontend: 根据需求生成前端开发提示

快速开始

1. 安装依赖

cd mcp-server
npm install

2. 配置环境变量

复制 .env.example 为 .env 并填写你的 API Key：

REDMINE_URL=https://your-redmine.com
REDMINE_API_KEY=your_redmine_api_key
FIGMA_API_KEY=your_figma_api_key

3. 构建

npm run build

4. 配置 MCP 客户端

Claude Desktop 配置

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "redmine-figma": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "REDMINE_URL": "https://your-redmine.com",
        "REDMINE_API_KEY": "your_redmine_api_key",
        "FIGMA_API_KEY": "your_figma_api_key"
      }
    }
  }
}

Qoder 配置

在 .qoder/mcp.json 中添加：

{
  "servers": [
    {
      "name": "redmine-figma",
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "REDMINE_URL": "https://your-redmine.com",
        "REDMINE_API_KEY": "your_redmine_api_key",
        "FIGMA_API_KEY": "your_figma_api_key"
      }
    }
  ]
}

使用示例

获取 Redmine 需求

请帮我查看 Redmine 需求 #12345

分析 Figma 设计

请分析这个 Figma 设计: https://www.figma.com/file/ABC123/FileName

生成前端开发提示

帮我查看 Redmine 需求 #12762，生成前端开发提示

分享给他人使用

方式一：直接分享代码

1. 将整个 mcp-server 文件夹打包分享
2. 对方解压后执行：

   cd mcp-server
   npm install
   npm run build

3. 修改 .env 文件中的 API Key
4. 配置到对方的 MCP 客户端

方式二：Git 仓库分享

1. 将代码推送到 Git 仓库
2. 他人克隆后安装依赖：

   git clone <your-repo-url>
   cd mcp-server
   npm install
   npm run build

方式三：npm 包分享（高级）

1. 发布到 npm：

   npm publish

2. 他人全局安装：

   npm install -g your-mcp-server

3. 配置时使用命令路径：

   {
     "command": "your-mcp-server"
   }

开发

# 安装依赖
npm install

# 构建
npm run build

# 开发模式
npm run dev

项目结构

mcp-server/
├── src/
│   ├── index.ts          # MCP Server 入口
│   ├── redmine-client.ts # Redmine API 客户端
│   └── figma-client.ts   # Figma API 客户端
├── dist/                 # 编译输出
├── .env                  # 环境变量
├── package.json
└── tsconfig.json