使用说明
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服务器:
- 主要来源:
registry.json-包含可用MCP服务器的完整列表 - 次要来源:
servers/directory-每个服务器的单独JSON文件 - 后备方案:如果网络不可用,则内置示例服务器
该应用程序会定期刷新注册表,并在本地缓存数据以供离线访问。
📝 添加新的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指向可访问的存储库 - []经过测试的安装和基本功能
🔄 更新现有服务器
- 更新版本号
- 将新版本添加到
versions数组 - 更新
lastUpdated时间戳 - 更新所有更改的字段(工具、环境变量等)
📞 支持
📄 许可证
此目录在MIT下获得许可。单个MCP服务器可能有自己的许可证。