AI导哈

MCP服务器应用

一个使用Express + TypeScript + MCP SDK构建的MCP服务器示例项目，支持Redmine API集成。

  • by akiraNuma
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 akiraNuma/mcp-server-tutorial

使用说明

MCP服务器应用程序

概要

此目录是使用Express+TypeScript+MCP SDK的MCP服务器示例项目。

环境情报

Node.js版本

  • 推荐版本：Node.js 22.22.0( .node-version ），模板名称将采用不同的格式

使用版本控制工具设置

# mise を使用している場合
mise install

# nodenv を使用している場合
nodenv install 22.22.0
nodenv local 22.22.0

# nvm を使用している場合
nvm install 22.22.0
nvm use 22.22.0

安装过程

  1. 安装相关性
npm install
  1. 设置环境变量
cp .env.example .env
# .envファイルを編集して適切な値を設定してください
  1. 服务器启动（开发模式）
npm run dev

端点

  • http://localhost:3000/mcp（默认设置）

调试工具

npx @modelcontextprotocol/inspector

（应用编）Redmine连携机能

作为一个实践示例，我们实施了一个与Redmine API合作的工具。可以获取、制作、更新票证。

所需页眉

请从MCP客户端发送以下标题。

｜标题｜说明｜ | ------------------- | ------------------------------------------------------- | | x-redmine-url Redmine的基本URL（例如： https://redmine.example.com） | | x-redmine-api-key Redmine API密钥

如何获取Redmine API密钥

  1. 请求Redmine管理员设置“启用REST API”（管理→设置→API）
  2. 登录Redmine
  3. 右上角的帐户名→“个人设置”
  4. 在右窗格的“API访问密钥”栏中单击“显示”

客户端设置示例（VS代码）

# mcp.json
{
  "servers": {
    "redmine-mcp": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "x-redmine-url": "https://your-redmine.example.com",
        "x-redmine-api-key": "your-api-key-here"
      }
    }
  }
}

相关 MCP