AI导哈

MCP服务器集成工具

该项目展示了如何将Refold的MCP服务器集成到现有的代理基础设施中，利用Google的Agent Development Kit (ADK)构建自定义代理，并扩展其功能以实现企业级推理、编排和集成。

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

使用说明

🤖 重新折叠MCP服务器集成（带上自己的代理）

🔍 您在寻找Types/JavaScript示例吗？
此存储库包含 python 实施。对于Types/JavaScript示例，请导航到 js-sdk 分支.

此存储库演示了如何集成 Refold的MCP（模型上下文协议） 使用以下命令将服务器插入现有代理基础架构 谷歌的代理开发工具包（ADK）.

通过这个项目，你可以 自带代理（BYOA） --使用Google ADK或任何兼容框架构建，并使用Refold强大的MCP功能进行扩展，以实现企业级推理、编排和集成。

更多了解 重组.ai — 专为企业集成而构建的AI代理。

🚀 概述

此项目显示了如何创建连接到的代理 Refold的MCP服务器，允许您从自己的代理或应用程序中利用Refold的工具和推理堆栈。

  • 建立自己的ADK代理
  • 将其连接到Refold的MCP
  • 在本地或生产环境中运行它，并完全集成LLM

🧰 先决条件

  • python 3.13+
  • A. 重新折叠帐户 具有MCP访问权限
  • 访问您首选的 API有限责任公司 （模型）
  • uv 或 pip 作为包管理器

🔑 从Refold获取MCP URL

要集成Refold的MCP服务器，您需要从Refold平台获取MCP服务器URL：

  1. 导航到MCP服务器

    • 登录您的Refold帐户
    • 转到左侧导航栏中的“MCP服务器”部分

  2. 访问您的MCP服务器配置

    • 选择或创建您的MCP服务器（例如，“周一MCP服务器”）
    • 点击“概述”选项卡

  3. 复制您的服务器URL

    • 在 服务器详细信息 部分，你会发现 服务器URL 领域
    • 单击URL旁边的复制图标进行复制
    • URL格式如下： https://api.gocobalt.io/mcp/v1/eyJhbGciOiJIUzI1NilsInR5cCl6lkpXVCJ9...

📸 视觉指南：

图片显示 服务器URL 现场 服务器详细信息 选择后的部分 关联帐户，由指向它的箭头突出显示。这是您需要复制并用作您的URL MCP_URL 环境变量。

⚙️ 安装

使用紫外线（推荐）

# Install dependencies
uv sync

# Activate the virtual environment
source .venv/bin/activate  # On macOS/Linux
# or
.venv\Scripts\activate  # On Windows

使用pip

# Create a virtual environment
python -m venv .venv

# Activate the virtual environment
source .venv/bin/activate  # On macOS/Linux
# or
.venv\Scripts\activate  # On Windows

# Install dependencies
pip install -e .

配置

A. .env.example 文件提供在 my_agent/ 文件夹作为模板。复制它以创建您的 .env 文件：

cp my_agent/.env.example .env

然后编辑 .env 在项目根目录中创建文件并填写实际值：

MODEL_NAME="MODEL_NAME"
MODEL_URL="MODEL_URL"
MODEL_API_KEY="MODEL_API_KEY"
MCP_URL="REFOLD_MCP_URL"

注： 将占位符值替换为实际值：

  • MCP_URL：从您的Refold MCP服务器概述页面复制的服务器URL（格式： https://api.gocobalt.io/mcp/v1/your-token-here)
  • 型号名称：要使用的LLM模型的名称（例如，“gpt-4”、“claude-3-opus”）
  • MODEL_URL：您的LLM API提供商的基本URL（例如。， https://api.openai.com/v1)
  • 模式_ API_键：用于使用LLM服务进行身份验证的API密钥

项目结构

BYOA-MCP/
├── my_agent/
│   ├── __init__.py
│   ├── agent.py          # Main agent implementation
│   └── .env.example      # Environment variables template
├── img/
│   ├── refold_mcp_server.png  # Visual guide for finding MCP URL
│   └── showcase.png          # ADK Web interface screenshot
├── pyproject.toml        # Project dependencies
├── uv.lock              # Dependency lock file
├── .env                 # Environment variables (create from .env.example)
└── README.md           # This file

运作原理

代理人(my_agent/agent.py)创建一个代理实例，该实例：

  1. 初始化模型：使用LiteLLM连接到指定的LLM提供商
  2. 连接到回流MCP：用途 MCPToolset 随着 StreamableHTTPConnectionParams 连接到Refold的MCP服务器
  3. 提供工具：代理可以访问Refold的MCP服务器提供的所有工具
  4. 执行任务：可以通过MCP协议与Refold的功能进行交互

用法

使用ADK Web运行

运行和与代理交互的最简单方法是使用ADK的web界面：

adk web

这将启动一个web服务器，并将浏览器打开到一个交互式界面，您可以在其中：

  • 与您的代理人聊天
  • 实时查看代理的响应
  • 测试回流焊MCP集成
  • 监控代理交互和工具使用情况

ADK Web界面显示与代理的对话、函数调用和响应。您可以看到代理通过Refold的MCP集成成功地从Monday.com板检索数据。

web界面将自动从以下位置发现并加载您的代理 my_agent.agent.root_agent.

依赖项

  • 谷歌广告 （>=1.17.0）：谷歌用于构建代理的代理开发工具包
  • litellm （>=1.79.0）：多个LLM提供商的统一接口

支持

关于以下问题：

重组.ai© 2025年 - https://refold.ai/

相关 MCP