MCP Server Playground

🚀 MCP サーバープレイグラウンド

このリポジトリは、TypeScript で構築された MCP サーバーを実験するためのプレイグラウンドです。チュートリアルや個人用のバージョンとして、学習リソースとして、また Calude デスクトップ版や Cursor IDE との統合をテストするためのプラットフォームとして設計されています。

📚 背景

このプロジェクトは以下の資料に基づいています。

• 10分以内で TypeScript を使って最初の MCP サーバーを構築する
• MCP サーバーチュートリアルビデオ

元のチュートリアルは基礎を提供しており、それを拡張しています。チュートリアルの例に加えて、他のツールや機能を追加し、コードを MCP サーバーの実験用の堅牢なプレイグラウンドに発展させる予定です。

✨ 主な機能

• TypeScript ベースのサーバー：TypeScript を使用することで、より良い構造とエラーチェックを提供します。
• モジュール化設計：新しいコマンド、機能、統合を簡単に追加できます。
• 統合対応：Calude デスクトップ版や Cursor IDE との統合を目的として設計されており、開発体験を向上させます。
• 拡張可能なプレイグラウンド：チュートリアルの例を超えたツールや修正の実験用のサンドボックス環境を提供します。

🚀 クイックスタート

前提条件

• Node.js (v12 以上)
• npm（または Yarn、好みに応じて）
• TypeScript（グローバルにインストールされていない場合）

Smithery を通じたインストール

Smithery を通じて、Claude デスクトップ版用に MCP サーバープレイグラウンドを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install mcp-server-playground --client claude

インストール

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

   git clone <repo_url>
   cd mcp-server-playground
   

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

   npm install
   

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

   npm run build
   

設定

このプロジェクトは環境変数を使用しています。.env ファイルを作成して、設定オプションを設定してください。将来的にサンプルファイル（.env.example）が提供される場合は、それをテンプレートとして使用してください。

💻 開発

• IDE 統合：
  • Cursor IDE や Calude デスクトップ版とスムーズに統合されます。
  • これらの IDE がサポートする組み込みツールや拡張機能を利用して、生産性を向上させます。
• プロジェクトの拡張：
  • 新しいコマンドを自由に追加したり、既存の機能を統合または変更したりできます。
  • サーバーのモジュール化構造により、追加のツールや機能を簡単に組み込むことができます。

📚 プロジェクト構造

mcp-server-playground/
├── src/                # ソースコードディレクトリ
│   └── index.ts       # メインサーバーの実装
├── build/             # コンパイルされた JavaScript ファイル
├── package.json       # プロジェクトの依存関係とスクリプト
├── tsconfig.json     # TypeScript の設定
└── README.md         # プロジェクトのドキュメント

📦 利用可能なスクリプト

• npm run build - TypeScript コードをコンパイルし、適切な権限を設定します。
• npm run prepare - ビルドスクリプトを実行します（git フック用）。
• npm run watch - TypeScript ファイルの変更を監視します。
• npm run inspector - MCP チェックツールを実行します。

🤝 コントリビューション

コントリビューションを歓迎します！何か提案、改善策、または新しい統合がある場合は、リポジトリをフォークし、変更を加えてからプルリクエストを作成してください。

📄 参考資料

• 10分以内で TypeScript を使って最初の MCP サーバーを構築する
• MCP サーバーチュートリアルビデオ
• モデルコンテキストプロトコル SDK ドキュメント