多集成AI助手工具服务

一个基于Python的MCP服务器,为AI助手提供GitHub、Jira、REST API、Oracle和MongoDB等多种集成工具。

  • by AISmithy
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AISmithy/mcp-server

使用说明

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 运行聚合管道

添加新集成

  1. 创建 mcp_server/tools/<name>/ 随着 client.py 和 tools.py
  2. 用以下元素装饰每个工具功能 @tool("Category Name") 从 mcp_server.registry
  3. 将模块导入添加到 mcp_server/tools/__init__.py

该工具将自动出现在浏览器UI中,并可供MCP客户端使用。