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

このリポジトリは、TypeScriptで構築されたMCPサーバーを試すためのプレイグラウンドです。MCPサーバー構築に関するチュートリアルとビデオのカスタマイズ版であり、学習リソースとしてだけでなく、Calude DesktopおよびCursor IDEとの統合をテストするためのプラットフォームとしても活用できます。

背景

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

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

オリジナルのチュートリアルは私が拡張した基盤を提供してくれました。チュートリアルの例に加えて、ツールや機能を追加し、このコードをMCPサーバーの実験のための堅牢なプレイグラウンドへと進化させていく予定です。

特徴

• TypeScript ベースのサーバー: TypeScript を活用して構造とエラー チェックを改善します。
• **モジュラー設計:**新しいコマンド、機能、統合により簡単に拡張できます。
• 統合対応: Calude Desktop および Cursor IDE と連携して動作するように設計されており、開発エクスペリエンスが向上します。
• **拡張可能なプレイグラウンド:**チュートリアルの例以外にも追加のツールや変更を試すことができるサンドボックス環境。

はじめる

前提条件

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

Smithery経由でインストール

Smithery経由で Claude Desktop 用の MCP Server Playground を自動的にインストールするには:

インストール

1. リポジトリをクローンします。
   git clone <repo_url> cd mcp-server-playground
2. 依存関係をインストールします:
   npm install
3. プロジェクトをビルドします。
   npm run build

構成

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

発達

• IDE統合:
  • Cursor IDE および Calude Desktop とスムーズに連携するように設計されています。
  • これらの IDE でサポートされている組み込みツールと拡張機能を活用して、生産性を最大化します。
• プロジェクトの拡張:
  • 新しいコマンドや統合を自由に追加したり、既存の機能を変更したりすることができます。
  • サーバーのモジュール構造により、追加のツールや機能を簡単にプラグインできます。

プロジェクト構造

利用可能なスクリプト

• npm run build - TypeScriptコードをコンパイルし、適切な権限を設定します
• npm run prepare - ビルド スクリプトを実行します (git フックに便利です)
• npm run watch - TypeScript ファイルの変更を監視します
• npm run inspector - MCPインスペクターツールを実行します

貢献

貢献を歓迎します！提案、改善、または新しい統合がある場合は、リポジトリをフォークして、変更を加えたプルリクエストを作成してください。

参考文献

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

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

注記

このプロジェクトは、MCPサーバー向けの様々な適応と統合をテストすることを目的としたサンドボックス環境です。新しいツールやアイデアが開発されるにつれて、更新と拡張が行われます。

ロードマップ

• [ ] チュートリアルの例以外にもツール統合を実装する
• [ ] 各ツールの包括的なドキュメントを追加する
• [ ] Calude Desktopとのサンプル統合を作成する
• [ ] カーソルIDE統合用のカスタムツールの開発
• [ ] テストフレームワークと例を追加する