MCP Server Playground

🚀 MCP 服務器遊樂場

這個倉庫是一個用於實驗用 TypeScript 構建的 MCP 服務器的遊樂場。它是教程和個人化版本，旨在作為學習資源和測試與 Calude 桌面版和 Cursor IDE 的集成平臺。

🚀 快速開始

前置條件

• Node.js（v12 或更高版本）
• npm（或 Yarn，根據個人偏好）
• TypeScript（若未全局安裝）

通過 Smithery 安裝

要通過 Smithery 自動安裝 MCP 服務器遊樂場以供 Claude 桌面版使用，請執行以下命令：

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），可將其用作模板。

✨ 主要特性

• 基於 TypeScript 的服務器：使用 TypeScript 提供更好的結構和錯誤檢查。
• 模塊化設計：便於輕鬆擴展新的命令、功能和集成。
• 集成就緒：設計用於與 Calude 桌面版和 Cursor IDE 集成，以提高開發體驗。
• 可擴展的遊樂場：提供一個沙盒環境，用於實驗工具和修改，超越教程示例。

📦 安裝指南

前置要求

• Node.js (v12 或更高版本)
• npm（或 Yarn，基於你的偏好）
• TypeScript（如果未全局安裝）

通過 Smithery 安裝

要通過 Smithery 自動安裝 MCP 服務器遊樂場以供 Claude 桌面版使用：

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），請將其用作模板。

💻 使用示例

基礎用法

目前文檔未提供基礎用法的代碼示例。

高級用法

目前文檔未提供高級用法的代碼示例。

📚 詳細文檔

背景

該項目基於以下材料：

• 在 10 分鐘內使用 TypeScript 構建你的第一個 MCP 服務器
• MCP 服務器教程視頻

原始教程提供了一個基礎，開發者在此基礎上進行了擴展。除了教程中的示例之外，還計劃添加其他工具和功能，使代碼發展成為一個穩健的遊樂場，用於 MCP 服務器實驗。

開發相關

• 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 檢查工具

貢獻說明

歡迎貢獻！如果你有任何建議、改進或新的整合，請 fork 該倉庫並在你的更改中創建 pull request。

參考資料

• 在 10 分鐘內使用 TypeScript 構建你的第一個 MCP 服務器
• MCP 服務器教程視頻
• 模型上下文協議 SDK 文檔