🤖 重新折叠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：
- 导航到MCP服务器
- 登录您的Refold帐户 - 转到左侧导航栏中的“MCP服务器”部分
- 访问您的MCP服务器配置
- 选择或创建您的MCP服务器（例如，“周一MCP服务器”） - 点击“概述”选项卡
- 复制您的服务器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)创建一个代理实例，该实例：
- 初始化模型：使用LiteLLM连接到指定的LLM提供商
- 连接到回流MCP：用途
MCPToolset随着StreamableHTTPConnectionParams连接到Refold的MCP服务器 - 提供工具：代理可以访问Refold的MCP服务器提供的所有工具
- 执行任务：可以通过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/