MCP Typescript Tools Server

🚀 MCP TypeScript ツールサーバー

このサーバーは、TypeScriptで実装されたModel Context Protocol (MCP) サーバーで、Claudeなどの大規模言語モデルに使用できる様々な便利なツールを提供します。このサーバーには、電卓、日付・時間ツール、メモツールが含まれており、さらに多くのツールを追加するための拡張可能なアーキテクチャを備えています。

✨ 主な機能

• 🧮 基本的な数学演算を行う電卓ツール
• 📅 さまざまな形式で現在の日付や時間を表示するツール
• 📝 テキストメモの保存と検索ツール
• 🔌 Claudeデスクトップ版とCursorと互換性がある
• 🚀 新しいツールを簡単に追加できる拡張性

📦 インストール

前提条件

• Node.js（v16以上）
• npm（Node.jsに付属）
• Claudeデスクトップ版および/またはCursor（ツールを使用するため）

インストール手順

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

git clone <your-repo-url>
cd MCP

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

npm install

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

npm run build

💻 Claudeデスクトップ版との設定

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デスクトップ版を再起動します。
4. 入力ボックスにハンマーアイコンが表示されることを確認して、ツールが使用可能になったことを確認します。

💻 Cursorとの設定

1. Cursorを開きます。
2. Cursor設定 > 機能 > MCP に移動します。
3. + 新しいMCPサーバーを追加 をクリックします。
4. フォームに以下の情報を入力します：
   • タイプ：stdio
   • 名前：MCPllmContext
   • コマンド：node ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js

💻 使用例

利用可能なツール

電卓

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

日付・時間

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

メモ

• ツール名：save-note, get-note, list-notes
• 説明：テキストメモの保存と検索を行います。
• 使用方法：「タイトルが'Meeting'で内容が'Discuss project'のメモを保存して」

新しいツールの追加

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("パラメータの説明") 
    },
    async ({ param }) => {
      return {
        content: [{ type: "text", text: "結果" }]
      };
    }
  );
}

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

🔧 開発

# プロジェクトをビルドする
npm run build

# サーバーを直接実行する
node dist/index.js

# 変更を監視する（nodemonをインストールしている場合）
nodemon dist/index.js

🔧 トラブルシューティング

Claudeデスクトップ版の問題

• ログを確認します：%APPDATA%\Claude\logs\mcp*.log（Windows）または ~/Library/Logs/Claude/mcp*.log（macOS）
• claude_desktop_config.json のパスが絶対パスで正しいことを確認します。
• Claudeデスクトップ版を再起動してから再度試してみます。

Cursorの問題

• 最新バージョンのCursorを使用していることを確認します。
• コンソールにエラーメッセージが表示されていないか確認します。
• 問題が解決しない場合は、Cursorのサポートチームに問い合わせてください。