JinDaGe - souls-mcp-srv MCP Details

article

README

🚀 探索卓越的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"
}

最佳实践

字段组织：保持配置键的字母顺序排列。
标识符要求：
- 必须是唯一的字母数字字符串，且首字母为字母。
- 严格禁止数字前缀。
元数据处理：
- 可选 name 字段默认显示为 key 的值。
- 环境变量和主页URL为辅助字段。

用户自定义参数

针对交互式参数需求，请遵循标准化格式：

{{paramName@paramType::paramDescription}}

此约定使客户端应用程序能够提取并展示参数。

参数提取示例

{
  "name": "dirs", 
  "type": "list",
  "description": "即将访问的目录。包含末尾斜杠"
}

字段约束

paramName 在服务器配置中必须唯一。
支持的数据类型包括字符串、列表和数字，请确保使用正确的类型！
描述性文本可选。

souls-mcp-srv