MCP服务器目录

PowerHub Store的官方MCP服务器目录,用于集中注册和管理可通过PowerHub Store界面安装的MCP服务器。

  • by The-Nexus-V
  • 本地部署
  • 更新于
在 GitHub 查看 The-Nexus-V/MCP-Directory

使用说明

PowerHub MCP目录

MCP(模型上下文协议)服务器的官方目录 PowerHub商店 在Nexus-V中。

此存储库充当MCP服务器的中央注册表,可以通过PowerHub Store界面安装和管理MCP服务器。

📦 结构

MCP-Directory/
├── registry.json          # Main registry file with all MCP servers
├── servers/               # Individual server configuration files
│   ├── github.json
│   ├── notion.json
│   └── ...
├── [server-name]/         # Legacy server directories (for icons/assets)
│   ├── server.json
│   ├── icon.svg
│   └── README.md
└── README.md

🚀 PowerHub商店的工作原理

Nexus-V应用程序会自动从此存储库中获取MCP服务器:

  1. 主要来源: registry.json -包含可用MCP服务器的完整列表
  2. 次要来源: servers/ directory-每个服务器的单独JSON文件
  3. 后备方案:如果网络不可用,则内置示例服务器

该应用程序会定期刷新注册表,并在本地缓存数据以供离线访问。


📝 添加新的MCP服务器

选项1:添加到注册表.json(推荐)

将您的服务器条目添加到 servers 数组in registry.json:

{
  "id": "mcp-server-your-service",
  "packageName": "your-package-name",
  "name": "Your Service Name",
  "description": "Short description of your MCP server",
  "longDescription": "Detailed description with features...",
  "author": {
    "name": "Author Name",
    "url": "https://your-website.com",
    "verified": false
  },
  "version": "1.0.0",
  "versions": [
    { "version": "1.0.0", "releaseDate": "2024-01-01", "minProtocolVersion": "2024-11-05" }
  ],
  "category": "api-integration",
  "tags": ["tag1", "tag2", "tag3"],
  "repositoryUrl": "https://github.com/your/repo",
  "license": "MIT",
  "installSource": "npm",
  "installCommand": "@your-org/mcp-server",
  "transportType": "stdio",
  "permissions": [],
  "capabilities": {
    "tools": { "listChanged": true }
  },
  "tools": [],
  "resources": [],
  "prompts": [],
  "requiredEnvVars": [],
  "optionalEnvVars": [],
  "minProtocolVersion": "2024-11-05",
  "downloads": 0,
  "rating": 0,
  "ratingCount": 0,
  "reviews": [],
  "lastUpdated": "2024-01-01T00:00:00Z",
  "createdAt": "2024-01-01T00:00:00Z",
  "isVerified": false,
  "isFeatured": false
}

选项2:创建单独的服务器文件

在中创建一个新的JSON文件 servers/ 目录:

servers/your-service.json

📋 服务器配置架构

必填字段

字段 类型 描述
id string 唯一标识符(例如。, mcp-server-github)
packageName string NPM包名或Docker镜像
name string 显示名称
description string 简短描述(最多150个字符)
author object 作者信息
version string 当前版本(semver)
versions array 版本历史记录
category string 服务器类别
tags array 搜索标签
license string 许可证标识符
installSource 字符串 npm, docker, url,或 git
installCommand string 安装命令/URL
transportType 字符串 stdio, http,或 streamable-http
minProtocolVersion string 最低MCP协议版本
downloads number 下载次数
rating number 平均评分(0-5)
ratingCount number 评级数量
lastUpdated string ISO 8601时间戳
createdAt string ISO 8601时间戳
isVerified boolean 由维护人员验证
isFeatured boolean 店内精选

可选字段

字段 类型 描述
longDescription string 详细描述(支持markdown)
repositoryUrl string 源代码库
homepageUrl string 项目主页
documentationUrl string 文档链接
permissions array 所需权限
capabilities object 服务器功能
tools array 可用工具
resources array 可用资源
prompts array 可用提示
requiredEnvVars array 必需的环境变量
optionalEnvVars array 可选环境变量
reviews array 用户评论
screenshots array 截图URL
securityWarnings array 安全警告
dependencies array 依赖关系

🏷️ 分类

使用以下类别之一:

类别 描述
file-system 文件和存储操作
database 数据库集成
api-integration 第三方API集成
development 开发工具
productivity 生产力工具
communication 消息和通信
ai-ml AI/ML工具
security 安全工具
monitoring 监控和可观察性
data-processing 数据处理工具
cloud-services 云平台集成
version-control 版本控制系统
documentation 文档工具
testing 测试框架
other 其他工具

🔧 环境变量

定义必需和可选的环境变量:

{
  "requiredEnvVars": [
    {
      "name": "API_KEY",
      "description": "Your API key for authentication",
      "isSecret": true,
      "example": "sk-xxxxxxxxxxxx"
    }
  ],
  "optionalEnvVars": [
    {
      "name": "API_BASE_URL",
      "description": "Custom API base URL",
      "defaultValue": "https://api.example.com"
    }
  ]
}

🛠️ 工具定义

定义服务器提供的工具:

{
  "tools": [
    {
      "name": "tool_name",
      "description": "What this tool does",
      "isReadOnly": true,
      "isDestructive": false
    }
  ]
}
  • isReadOnly:工具只读取数据,不修改任何内容
  • isDestructive:工具可以删除或永久修改数据

🔒 权限

定义所需权限:

{
  "permissions": [
    {
      "type": "read",
      "scope": "resource-name",
      "description": "What this permission allows",
      "required": true,
      "warning": "Optional security warning"
    }
  ]
}

权限类型: read, write, execute, admin


✅ 提交清单

在提交PR之前:

  • []独特 id 这与现有服务器不冲突
  • []有效 packageName 可以安装
  • []清晰简洁 description
  • []正确 category 从上面的列表
  • []至少3个相关 tags
  • []有效 transportType (stdio, http,或 streamable-http)
  • []全部 requiredEnvVars 用描述记录
  • []全部 tools 列出描述
  • []有效 license 标识符
  • [ ] repositoryUrl 指向可访问的存储库
  • []经过测试的安装和基本功能

🔄 更新现有服务器

  1. 更新版本号
  2. 将新版本添加到 versions 数组
  3. 更新 lastUpdated 时间戳
  4. 更新所有更改的字段(工具、环境变量等)

📞 支持


📄 许可证

此目录在MIT下获得许可。单个MCP服务器可能有自己的许可证。