A simple MCP Server

シンプルな MCP サーバー

ユーザーデータ管理ツールを提供する、Model Context Protocol（MCP）サーバーの実装です。

機能

• ユーザーデータ取得ツール
• TypeScript による実装
• ES Modules のサポート
• TypeScript のコンパイル機能を内蔵

前提条件

• Node.js（v20 以降）
• npm（v9 以降）

インストール

1. リポジトリをクローンします。

git clone https://github.com/fujahgabriel/simple-mcp-server.git
cd simple-mcp-server

2. 依存関係をインストールします。

npm install

開発

プロジェクトのビルド

TypeScript ファイルをビルドするには、次のコマンドを実行します。

npm run build

これにより、次の処理が行われます。

• TypeScript ファイルを JavaScript にコンパイルします
• ファイルを build ディレクトリに出力します
• 出力ファイルに適切な権限を設定します

開発モード

変更を監視し、自動的に再ビルドするには、次のコマンドを実行します。

npm run watch

MCP Inspector の使用

MCP サーバーのツールを調査およびテストするには、次の手順に従います。

1. まず、プロジェクトをビルドします。

npm run build

2. MCP Inspector を起動します。

npm run inspector

3. Inspector は http://localhost:5173 で利用できます。

MCP の設定

この MCP サーバーを Cursor で使用するには、MCP の設定で構成する必要があります。次の設定を ~/.cursor/mcp.json に追加します。

{
  "my-mcp-server": {
    "math": {
      "command": "node",
      "args": ["build/index.js"]
    }
  }
}

次の点を確認してください。

1. まず npm run build を使用してプロジェクトをビルドします
2. ビルドされた JavaScript ファイルへの正しいパスを使用します
3. 設定を更新した後、Cursor を再起動します

利用可能なツール

get_users

すべてのユーザーの一覧を取得します。

get_user

名前を指定して特定のユーザーを取得します。

パラメーター：

• user：string - 取得するユーザーの名前

プロジェクト構成

mcp-server/
├── build/           # Compiled JavaScript files
├── index.ts         # Main server implementation
├── package.json     # Project dependencies and scripts
└── tsconfig.json    # TypeScript configuration

依存関係

• @modelcontextprotocol/sdk：サーバー実装用の MCP SDK
• dotenv：環境変数の管理
• typescript：TypeScript コンパイラー
• zod：実行時の型検証

ライセンス

MIT