使用说明
MCP服务器中心
基于Python 模型上下文协议 (MCP)服务器,公开用于多种集成的工具——GitHub、Jira、REST API、Oracle和MongoDB——供人工智能助手使用。
先决条件
- Python 3.10+
- 要使用的集成的凭据(请参阅 配置)
安装
pip install -e .
浏览器用户界面
在SSE模式下启动服务器,打开浏览器UI以交互方式探索和测试所有工具:
python -m mcp_server --sse
然后打开: http://localhost:8000/ui
工具按侧边栏中的集成进行分组。选择一个工具,填写参数,然后单击 跑.
配置
每个集成都是通过设置其环境变量来激活的。启动时会优雅地跳过没有凭据的集成。
GitHub
export GITHUB_TOKEN="ghp_your_token_here"
Jira
export JIRA_URL="https://your-org.atlassian.net"
export JIRA_USERNAME="you@example.com"
export JIRA_API_TOKEN="your_api_token"
REST API
export REST_API_BASE_URL="https://api.example.com"
export REST_API_TOKEN="your_token" # optional
export REST_API_TOKEN_HEADER="Authorization" # optional, default: Authorization
export REST_API_TOKEN_PREFIX="Bearer" # optional, default: Bearer
Oracle数据库
export ORACLE_USER="your_user"
export ORACLE_PASSWORD="your_password"
export ORACLE_DSN="host:port/service_name"
MongoDB
export MONGODB_URI="mongodb://localhost:27017"
export MONGODB_DATABASE="your_database"
在Windows(PowerShell)上,使用 $env:VAR = "value" 语法。
用法
直接运行(stdio--用于MCP客户端)
mcp-server-hub
使用浏览器UI运行(SSE模式)
mcp-server-hub --sse
# or
python -m mcp_server --sse
VS代码/副本
添加到您的 .vscode/mcp.json:
{
"servers": {
"hub": {
"type": "stdio",
"command": "python",
"args": ["-m", "mcp_server"],
"env": {
"GITHUB_TOKEN": "ghp_your_token_here",
"JIRA_URL": "https://your-org.atlassian.net",
"JIRA_USERNAME": "you@example.com",
"JIRA_API_TOKEN": "your_api_token",
"MONGODB_URI": "mongodb://localhost:27017",
"MONGODB_DATABASE": "your_database"
}
}
}
}
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"hub": {
"command": "python",
"args": ["-m", "mcp_server"],
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}
可用工具
GitHub(11个工具)
| 工具 | 说明 |
|---|---|
github_search_repositories |
搜索GitHub存储库 |
github_get_repository |
获取有关存储库的详细信息 |
github_list_issues |
在存储库中列出问题 |
github_get_issue |
获取特定问题的详细信息 |
github_create_issue |
创建新问题 |
github_list_pull_requests |
在存储库中列出拉取请求 |
github_get_pull_request |
获取特定拉取请求的详细信息 |
github_get_file_contents |
从存储库获取文件或目录内容 |
github_list_branches |
列出存储库中的分支 |
github_list_commits |
列出存储库中的提交 |
github_search_code |
在GitHub上搜索代码 |
Jira(8工具)
| 工具 | 说明 |
|---|---|
jira_list_projects |
列出所有可访问的Jira项目 |
jira_search_issues |
使用JQL搜索问题 |
jira_get_issue |
获取问题的完整详细信息 |
jira_create_issue |
创建新问题 |
jira_update_issue |
更新现有问题的字段 |
jira_add_comment |
向问题添加评论 |
jira_list_transitions |
列出可用的工作流转换 |
jira_transition_issue |
将问题转换为新状态 |
REST API(5个工具)
| 工具 | 说明 |
|---|---|
rest_get |
发出HTTP GET请求 |
rest_post |
发出HTTP POST请求 |
rest_put |
发出HTTP PUT请求 |
rest_patch |
发出HTTP PATCH请求 |
rest_delete |
发出HTTP DELETE请求 |
Oracle数据库(5个工具)
| 工具 | 说明 |
|---|---|
oracle_execute_query |
执行SELECT查询并以JSON格式返回结果 |
oracle_execute_statement |
执行INSERT、UPDATE或DELETE语句 |
oracle_list_tables |
列出数据库中的表 |
oracle_describe_table |
描述表格的列 |
oracle_call_procedure |
调用存储过程 |
MongoDB(9个工具)
| 工具 | 说明 |
|---|---|
mongo_list_collections |
列出数据库中的所有集合 |
mongo_find |
使用筛选器查找文档 |
mongo_find_one |
查找单个文档 |
mongo_insert_document |
插入一个文档 |
mongo_insert_many |
插入多个文档 |
mongo_update_document |
更新文档 |
mongo_delete_document |
删除文档 |
mongo_count |
统计与筛选器匹配的文档 |
mongo_aggregate |
运行聚合管道 |
添加新集成
- 创建
mcp_server/tools/<name>/随着client.py和tools.py - 用以下元素装饰每个工具功能
@tool("Category Name")从mcp_server.registry - 将模块导入添加到
mcp_server/tools/__init__.py
该工具将自动出现在浏览器UI中,并可供MCP客户端使用。
