MB_MCP (Model Context Protocol)

MB_MCP (Model Context Protocol)

一个用于通过 Model Context Protocol (MCP) 将各种服务与 Claude 和其他大模型集成的 Python 包。

概述

MB_MCP 提供了各种服务的连接器，如 Slack、Google Drive、GitHub、Atlassian、PostgreSQL 等。它允许您通过统一的接口构建利用这些服务的应用程序，使创建强大的 AI 助手应用程序变得容易。

功能

• 多个服务连接器：

  • Slack
  • Google Drive
  • GitHub
  • Atlassian (Confluence & Jira)
  • PostgreSQL
  • Brave Search
  • Formatter

• Web 仪表盘：用于查询服务的简单 Web 界面

• 基于环境变量的配置：所有 API 密钥和凭证都存储在 .env 文件中以保证安全

安装

前置条件

• Python 3.8 或更高版本
• Docker（用于运行某些服务）

设置

1. 克隆存储库：

   git clone https://github.com/bigmb/mb_mcp.git
   cd mb_mcp
   

2. 安装包：

   pip install -e .
   

3. 设置环境变量：

   cp .env.example .env
   

   编辑 .env 文件并添加你的 API 密钥和凭证。

配置

以下环境变量需要在 .env 文件中设置：

API 密钥

ANTHROPIC_API_KEY=your_anthropic_api_key
OPENAI_API_KEY=your_openai_api_key
GOOGLE_API_KEY=your_google_api_key

Slack 配置

SLACK_BOT_TOKEN=your_slack_bot_token
SLACK_APP_TOKEN=your_slack_app_token
SLACK_TEAM_ID=your_slack_team_id

PostgreSQL 配置

POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=postgres
PG_CONNECTION_STRING=postgresql://host.docker.internal:5432/mydb

Google Drive 配置

GDRIVE_CREDENTIALS_PATH=/path/to/your/gdrive/credentials.json

GitHub 配置

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token

Atlassian 配置

# For Confluence Cloud
CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
[email protected]
CONFLUENCE_API_TOKEN=your_api_token

# For Jira Cloud
JIRA_URL=https://your-domain.atlassian.net
[email protected]
JIRA_API_TOKEN=your_api_token

Brave Search 配置

BRAVE_API_KEY=your_brave_api_key

使用

运行 Web 仪表盘

python -m mb_mcp.app

这将在 http://localhost:5000 启动一个 Flask 服务器，你可以在这里与服务交互。

以编程方式使用连接器

import asyncio
from mb_mcp.slack_connecter import run_app as run_slack_app

async def main():
    question = "Provide the recent updates in the channel in proper format: <channel_id>"
    result = await run_slack_app(question)
    print(result['messages'][-1].content)

if __name__ == "__main__":
    asyncio.run(main())

开发

项目结构

• mb_mcp/：主包目录
  • app.py：Flask Web 应用程序
  • *_connecter.py：针对不同服务的连接器模块
  • formatter_server.py：用于文本格式化的本地 MCP 服务
• query_dashboard/：Web 仪表盘前端
• servers/：MCP 服务实现。Docker 镜像从这里构建。mcp_servers (Anthropic MCP 的服务)

许可证

MIT