Psaboia MCP Server Example

🚀 MCP 服務器 playground

此倉庫是用於實驗使用 TypeScript 構建的 MCP 服務器的 playground。它結合了教程和個人化版本的視頻，既可以作為學習資源，也能作為測試與 Calude Desktop 和 Cursor IDE 集成的平臺。

🚀 快速開始

先決條件

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

通過 Smithery 安裝

要通過 Smithery 自動為 Calude Desktop 安裝 MCP Server Playground：

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

手動安裝

1. 克隆倉庫：

   git clone <repo_url>
   cd mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 構建項目：

   npm run build
   

4. 啟動服務器：

   npm start
   

配置

該項目使用環境變量。創建一個 .env 文件以設置你的配置選項。如果將來提供了一個示例文件（.env.example），請將其用作模板。

✨ 主要特性

• 基於 TypeScript 的服務器：利用 TypeScript 進行更好的結構化和錯誤檢查。
• 模塊化設計：易於擴展新的命令、功能和集成。
• 集成就緒：設計為與 Calude Desktop 和 Cursor IDE 一起工作，以實現更高效的開發體驗。
• 可擴展的 playground：一個沙箱環境，用於實驗工具和修改，超越教程示例。

📦 安裝指南

安裝步驟

通過 Smithery 自動安裝

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

手動克隆與安裝

git clone <repo_url>
cd mcp-server
npm install
npm run build
npm start

💻 使用示例

基礎用法

在完成安裝和配置後，你可以使用以下命令啟動服務器：

npm start

📚 詳細文檔

開發

• IDE 集成：
  • 設計為與 Cursor IDE 和 Calude Desktop 平滑工作。
  • 利用這些 IDE 支持的內置工具和擴展，以最大化生產力。
• 擴展項目：
  • 歡迎自由添加新的命令、集成或修改現有功能。
  • 服務器的模塊化結構使其易於插入新的工具和功能。

項目結構

mcp-server/
├── src/                # 源代碼目錄
│   └── index.ts       # 主服務器實現
├── build/             # 編譯後的 JavaScript 文件
├── package.json       # 項目依賴項和腳本
├── tsconfig.json     # TypeScript 配置
└── README.md          # 說明文件

可用腳本

• npm run build：構建項目。
• npm run start：啟動服務器。
• npm run test：運行測試。

貢獻

歡迎貢獻！請查看 CONTRIBUTING.md 以獲取更多信息。

參考文獻

• 從零開始構建你的第一個MCP服務器（用 TypeScript 下於10分鐘）
• MCP 服務器教程視頻

📄 許可證

項目許可證

備註

該項目旨在為 MCP 服務器的實驗和學習提供一個靈活且強大的環境。通過社區的努力，我們希望不斷改進和擴展其功能。