MCP TypeScript Tools Server

MCP TypeScript ツールサーバー

Claude などの LLM 向けに、さまざまなユーティリティツールを提供する TypeScript 製の Model Context Protocol（MCP）サーバー実装です。このサーバーには、計算、日時、メモの各ツールが含まれており、さらに多くのツールを追加できる拡張可能なアーキテクチャを備えています。

特長

• 🧮 基本的な数学演算を行う計算ツール
• 📅 さまざまな形式で現在の日付と時刻を取得する日時ツール
• 📝 テキストメモを保存・取得するメモツール
• 🔌 Claude for Desktop および Cursor に対応
• 🚀 新しいツールを簡単に追加できます

前提条件

• Node.js（v16 以降）
• npm（Node.js に付属）
• Claude for Desktop および／または Cursor（ツールの使用に必要）

インストール

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

git clone <your-repo-url>
cd MCP

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

npm install

3. プロジェクトをビルドします。

npm run build

Claude for Desktop の設定

1. Claude のデスクトップ設定ファイルを開くか、新規作成します。

   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

2. MCP サーバーの設定を追加します。

{
  "mcpServers": {
    "MCPllmContext": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js"
      ]
    }
  }
}

ABSOLUTE_PATH_TO_YOUR_PROJECT を、プロジェクトディレクトリの実際のパスに置き換えてください。

3. Claude for Desktop を再起動します。
4. 入力ボックスにハンマーのアイコンが表示され、ツールが利用可能になっていることを確認します。

Cursor の設定

1. Cursor を開きます。
2. Cursor Settings > Features > MCP に移動します。
3. + Add New MCP Server をクリックします。
4. フォームに入力します。
   • Type：stdio
   • Name：MCPllmContext
   • Command：node ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js

利用可能なツール

計算ツール

• ツール名：calculate
• 説明：数学式を評価します
• 使用例：「2 + 2 を計算」

日時

• ツール名：current-date
• 説明：現在の日付と時刻を返します
• 形式：「short」または「long」
• 使用例：「今日は何日ですか？」

メモ

• ツール名：save-note、get-note、list-notes
• 説明：テキストメモを保存・取得します
• 使用例：「タイトルを『会議』、内容を『プロジェクトについて話し合う』としてメモを保存」

新しいツールの追加

1. src/tools/ に新しいファイルを作成します（例：src/tools/myTool.ts）。
2. 次のテンプレートを使用してツールを実装します。

import { z } from "zod";
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

export function registerMyTools(server: McpServer) {
  server.tool(
    "tool-name",
    { 
      param: z.string().describe("Parameter description") 
    },
    async ({ param }) => {
      return {
        content: [{ type: "text", text: "Result" }]
      };
    }
  );
}

3. src/tools/index.ts でツールをエクスポートします。
4. src/index.ts でツールを登録します。

開発

# Build the project
npm run build

# Run the server directly
node dist/index.js

# Watch for changes (if you have nodemon installed)
nodemon dist/index.js

トラブルシューティング

Claude for Desktop の問題

• %APPDATA%\Claude\logs\mcp*.log（Windows）または ~/Library/Logs/Claude/mcp*.log（macOS）でログを確認します。
• claude_desktop_config.json のパスが絶対パスで、正しいことを確認します。
• サーバーがビルドされていることを確認します（npm run build）。
• 設定を変更した後は、Claude for Desktop を再起動します。

Cursor の問題

• Cursor の MCP 設定で、コマンドのパスを確認します。
• MCP 設定でツール一覧を更新してみます。
• Cursor のログにエラーメッセージがないか確認します。