Souls MCP Srv

🚀 探索卓越的MCP服務器

MCPSvr是一個創新的平臺，它源自 5ire 項目，致力於打造一個由社區驅動的MCP服務器目錄。藉助這個平臺，開發者不僅能夠輕鬆發現優質的工具，還能便捷地分享自己的MCP服務器作品。

🚀 這裡的服務器支持像5ire這樣的MCP客戶端直接安裝和運行。

https://github.com/user-attachments/assets/3d1ec8db-2041-4f2d-b72c-eb8ae17ab31c

🚀 快速開始

MCPSvr為開發者提供了一個便捷的途徑來參與MCP服務器的建設和使用。通過這個平臺，開發者可以發現和分享優質的MCP服務器資源。

✨ 主要特性

• 社區驅動：由社區共同維護和發展，匯聚了眾多開發者的智慧和資源。
• 便捷分享：開發者可以輕鬆地分享自己的MCP服務器作品。
• 客戶端支持：支持像5ire這樣的MCP客戶端直接安裝和運行。

📦 安裝指南

本項目暫未提供具體的安裝步驟，你可以持續關注項目的更新。

💻 使用示例

基礎用法

以下是一個MCP服務器配置的基礎示例：

{
  "name": "服務器標識符",
  "key": "唯一的字母數字標識符",
  "description": "簡要實現概述",
  "command": "執行環境指定符（如uvx、npx、python、node）", 
  "args": [
    "必需運行時參數"
  ],
  "env": {
    "環境變量名稱": "賦值"
  },
  "homepage": "官方文檔URL"
}

高級用法

以下是一個包含用戶自定義參數的高級示例：

{
  "name": "文件系統訪問控制",
  "key": "FileSystem", 
  "command": "npx",
  "description": "通過指定參數對目錄級操作實施限制",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "{{dirs@list::即將訪問的目錄。包含末尾斜槓}}"
  ],
  "homepage": "https://github.com/modelcontextprotocol/servers"
}

📚 詳細文檔

貢獻指南

所有註冊的MCP服務器配置均集中維護於 /public/servers.json 倉庫中。開發者可通過GitHub拉取請求（PR）提交新的服務器配置。

配置方案

服務器配置需要遵循特定的格式，具體如下：

{
  "name": "服務器標識符",
  "key": "唯一的字母數字標識符",
  "description": "簡要實現概述",
  "command": "執行環境指定符（如uvx、npx、python、node）", 
  "args": [
    "必需運行時參數"
  ],
  "env": {
    "環境變量名稱": "賦值"
  },
  "homepage": "官方文檔URL"
}

最佳實踐

1. 字段組織：保持配置鍵的字母順序排列。
2. 標識符要求：
   • 必須是唯一的字母數字字符串，且首字母為字母。
   • 嚴格禁止數字前綴。
3. 元數據處理：
   • 可選 name 字段默認顯示為 key 的值。
   • 環境變量和主頁URL為輔助字段。

用戶自定義參數

針對交互式參數需求，請遵循標準化格式：

{{paramName@paramType::paramDescription}}

此約定使客戶端應用程序能夠提取並展示參數。

參數提取示例

{
  "name": "dirs", 
  "type": "list",
  "description": "即將訪問的目錄。包含末尾斜槓"
}

字段約束

• paramName 在服務器配置中必須唯一。
• 支持的數據類型包括字符串、列表和數字，請確保使用正確的類型！
• 描述性文本可選。