使用说明
Pipedream MCP服务器
⚠️ 重要通知:此MCP服务器是 仅供参考实施 并且不再被积极维护。对于生产使用,我们建议使用Pipedream的 远程MCP服务器 相反。
推荐:使用Pipedream的远程MCP服务器
为了获得最佳体验,请使用Pipedream的托管MCP服务器,该服务器提供:
- 2800多个API和10000多个工具 通过单一服务器
- 内置身份验证:不需要手动令牌管理
- 多种工具模式:子代理和完整配置
- 自动应用程序发现
- 企业级可靠性和安全性
🚀 开始: Pipedream MCP文档
🎮 现在试试:查看我们的 开源聊天应用 在 聊天.pipedream.com
自托管(参考实施)
此参考实现展示了如何:
查看面向消费者的MCP服务器的运行情况,网址为 mcp.pipedream.com 并查看面向开发人员的产品演示,网址为 聊天.pipedream.com.
我们发布了这段代码作为参考,这样您就可以更好地理解如何将Pipedream Connect用于这样的应用程序。这是一个专门用于自托管服务器的参考实现,可能没有完整的文档记录。
对于生产使用,我们强烈建议使用我们的 远程MCP服务器 相反。
⭐ 参考实施特征
- 跑 您自己的MCP服务器 为了 2800多个应用程序和API
- 管理服务器 为您的用户,在您自己的应用程序中
- 连接帐户、配置参数和发出API请求,所有这些都通过工具实现
- 完全管理的OAuth和凭据存储(请参阅安全文档)
🚀 入门指南
Pipedream的MCP服务器使用 Piped梦连接API 以管理身份验证并发出API请求。要运行MCP服务器,您需要一个Pipeddream项目和Pipeddreamneneneba API证书。
- 注册Pipedream
- 创建项目。通过MCP连接的任何帐户都将存储在此处。
- 创建Pipedream OAuth客户端
- 设置环境变量(请参见
.env.example)(直接在shell会话、点文件等中):
PIPEDREAM_CLIENT_ID=your_client_id
PIPEDREAM_CLIENT_SECRET=your_client_secret
PIPEDREAM_PROJECT_ID=your_project_id
PIPEDREAM_PROJECT_ENVIRONMENT=development
要理解的Pipedream概念
如果你正在为你的应用运行MCP服务器,你可能会想使用 SSE接口SSE服务器接受两个路由参数:
external_user_id--这是您系统中的用户ID,无论您使用什么来唯一标识它们。对该路由的任何请求都会耦合到该最终用户,并将使用该用户的身份验证Pipedream存储。 查看文档 了解更多细节。app--应用程序的“name slug”(应用程序的唯一标识符),位于 认证 部分 任何Pipedream应用程序例如,应用程序slug Slack 是slack.
如果你的用户 123 想要连接到 slack MCP服务器,您的MCP客户端将向 /123/slack 路线。 请参阅下面的SSE文件 了解更多细节。
服务器概述
有两种方法可以使用此MCP服务器。
1-特定于应用程序
/{external_user_id}/{app}
目前可在 mcp.pipedream.com。您可以为每个应用程序使用端点。
该应用程序可用的所有工具都将在该端点可用。
2-动态
/{external_user_id}
这是一个实验版本,因为它依赖于能够动态更新的工具。
我们使用此服务器为工具供电 聊天.pipedream.com.
[!注意]> 查看文档 了解有关使用MCP服务器启用应用程序发现的更多信息。
发展
cp .env.example .env 并填写开发项目的详细信息。
pnpm install
使用流式HTTP传输启动服务器
pnpm dev:http
您可以使用可选的env var PD_SDK_DEBUG 打印所有发送到Connect API的请求和响应
PD_SDK_DEBUG=true pnpm dev:http
然后运行检查器:
npx @modelcontextprotocol/inspector
使用 http://localhost:3010/v1/{external_user_id}/{app} 用于流式HTTP传输或 http://localhost:3010/{external_user_id}/{app} 苏格兰和南方能源公司运输。
这些URL也可以被其他客户端使用(例如Cursor)。
标准运输设置
Stdio仅由MCP检查员进行了测试。
npx @modelcontextprotocol/inspector bun src/stdio.ts
查看检查器URL的日志。
确保检查员的左侧与此相匹配:
然后按“列出工具”以获取MCP工具列表。
许可证
Pipedream源代码可用许可证版本1.0-请参阅https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE