A Simple MCP Server

🚀 シンプルなMCPサーバー

ユーザーデータ管理ツールを提供するModel Context Protocol (MCP)サーバーの実装です。このサーバーは、ユーザーデータの管理や操作を効率的に行うための機能を備えています。

🚀 クイックスタート

このMCPサーバーを使用するには、以下の手順に従ってください。

✨ 主な機能

• ユーザーデータ検索ツール
• TypeScriptで実装
• ESモジュールをサポート
• 組み込みの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インスペクターの使用

MCPサーバーツールをチェックおよびテストするには、以下の手順に従ってください：

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

npm run build

2. MCPインスペクターを起動します：

npm run inspector

3. インスペクターは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/           # コンパイル後のJavaScriptファイル
├── index.ts         # メインサーバーの実装
├── package.json     # プロジェクトの依存関係とスクリプト
└── tsconfig.json    # TypeScriptの構成

依存関係

• @modelcontextprotocol/sdk: MCP SDKをサーバー実装に使用
• dotenv: 環境変数の管理
• typescript: TypeScriptコンパイラ
• zod: ランタイム型検証

📄 ライセンス

MITライセンスです。