mcp-server-orchestrator by 4444j99/a-i--skills
npx skills add https://github.com/4444j99/a-i--skills --skill mcp-server-orchestrator管理面向 AI 驱动开发工作流的 MCP 服务器基础设施。
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ MCP Client │────▶│ MCP Server │────▶│ External APIs │
│ (Claude, etc.) │◀────│ (Tool Provider) │◀────│ (Services) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │
└───── JSON-RPC ────────┘
核心概念:
| 客户端 | 配置文件 | 平台 |
|---|---|---|
| Claude Desktop | claude_desktop_config.json |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
macOS: ~/Library/Application Support/Claude/ |
Windows: %APPDATA%\Claude\ |
| Claude Code | settings.json 或 MCP 配置 | 项目级或用户设置 |
| Cline | cline_mcp_settings.json | VS Code 扩展设置 |
{
"mcpServers": {
"server-name": {
"command": "executable",
"args": ["arg1", "arg2"],
"env": {
"API_KEY": "value"
},
"disabled": false
}
}
}
Python 服务器 (uvx):
{
"my-python-server": {
"command": "uvx",
"args": ["--from", "package-name", "server-command"]
}
}
Node 服务器 (npx):
{
"my-node-server": {
"command": "npx",
"args": ["-y", "@scope/package-name"]
}
}
本地开发服务器:
{
"dev-server": {
"command": "python",
"args": ["-m", "my_server"],
"env": {
"DEBUG": "true"
}
}
}
验证服务器可独立启动:
# 测试 Python 服务器
python -m my_server
# 测试 Node 服务器
npx -y @scope/package-name
检查日志:
~/Library/Logs/Claude/mcp*.log验证 JSON 配置:
python -c "import json; json.load(open('config.json'))"
常见修复方法:
from fastmcp import FastMCP
mcp = FastMCP("my-server")
@mcp.tool()
def my_tool(param: str) -> str:
"""Tool description for the AI."""
return f"Result: {param}"
@mcp.resource("resource://my-data")
def get_data() -> str:
"""Provide data as a resource."""
return "Resource content"
if __name__ == "__main__":
mcp.run()
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server({ name: "my-server", version: "1.0.0" }, {
capabilities: { tools: {} }
});
server.setRequestHandler(ListToolsRequestSchema, async () => ({
tools: [{
name: "my_tool",
description: "Tool description",
inputSchema: { type: "object", properties: { param: { type: "string" } } }
}]
}));
const transport = new StdioServerTransport();
await server.connect(transport);
按领域组织服务器:
{
"mcpServers": {
"filesystem": { "command": "...", "args": ["--allowed-dirs", "/projects"] },
"database": { "command": "...", "env": { "DB_URL": "..." } },
"api-integrations": { "command": "...", "env": { "API_KEYS": "..." } },
"custom-tools": { "command": "python", "args": ["-m", "my_tools"] }
}
}
将服务器视为合成器中的模块——根据工作流需求将它们组合在一起:
references/server-templates.md - 常见服务器类型的模板references/debugging-guide.md - 详细的故障排除步骤每周安装量
1
仓库
GitHub 星标数
2
首次出现
1 天前
安全审计
安装于
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
Manage MCP server infrastructure for AI-powered development workflows.
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ MCP Client │────▶│ MCP Server │────▶│ External APIs │
│ (Claude, etc.) │◀────│ (Tool Provider) │◀────│ (Services) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │
└───── JSON-RPC ────────┘
Key concepts:
| Client | Config File | Platform |
|---|---|---|
| Claude Desktop | claude_desktop_config.json | macOS: ~/Library/Application Support/Claude/ |
Windows: %APPDATA%\Claude\ | ||
| Claude Code | settings.json or MCP config | Project-level or user settings |
| Cline | cline_mcp_settings.json | VS Code extension settings |
{
"mcpServers": {
"server-name": {
"command": "executable",
"args": ["arg1", "arg2"],
"env": {
"API_KEY": "value"
},
"disabled": false
}
}
}
Python Server (uvx) :
{
"my-python-server": {
"command": "uvx",
"args": ["--from", "package-name", "server-command"]
}
}
Node Server (npx) :
{
"my-node-server": {
"command": "npx",
"args": ["-y", "@scope/package-name"]
}
}
Local Development Server :
{
"dev-server": {
"command": "python",
"args": ["-m", "my_server"],
"env": {
"DEBUG": "true"
}
}
}
Verify server starts independently :
# Test Python server
python -m my_server
# Test Node server
npx -y @scope/package-name
Check logs :
~/Library/Logs/Claude/mcp*.logValidate JSON config :
python -c "import json; json.load(open('config.json'))"
Common fixes :
from fastmcp import FastMCP
mcp = FastMCP("my-server")
@mcp.tool()
def my_tool(param: str) -> str:
"""Tool description for the AI."""
return f"Result: {param}"
@mcp.resource("resource://my-data")
def get_data() -> str:
"""Provide data as a resource."""
return "Resource content"
if __name__ == "__main__":
mcp.run()
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server({ name: "my-server", version: "1.0.0" }, {
capabilities: { tools: {} }
});
server.setRequestHandler(ListToolsRequestSchema, async () => ({
tools: [{
name: "my_tool",
description: "Tool description",
inputSchema: { type: "object", properties: { param: { type: "string" } } }
}]
}));
const transport = new StdioServerTransport();
await server.connect(transport);
Organize servers by domain:
{
"mcpServers": {
"filesystem": { "command": "...", "args": ["--allowed-dirs", "/projects"] },
"database": { "command": "...", "env": { "DB_URL": "..." } },
"api-integrations": { "command": "...", "env": { "API_KEYS": "..." } },
"custom-tools": { "command": "python", "args": ["-m", "my_tools"] }
}
}
Think of servers as modules in a synthesizer—patch them together based on workflow needs:
references/server-templates.md - Boilerplate for common server typesreferences/debugging-guide.md - Detailed troubleshooting proceduresWeekly Installs
1
Repository
GitHub Stars
2
First Seen
1 day ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
147,400 周安装