Mcp Server Tutorial

MCP Server Application

概要

このディレクトリは、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 Code）

# 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"
      }
    }
  }
}

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: akiraNuma
• Source: akiraNuma/mcp-server-tutorial
• License: MIT

Install and usage instructions live in the source repository linked above.