Pipedream MCP 服务器

⚠️ 重要通知：此 MCP 服务器仅为参考实现，不再积极维护。对于生产环境，我们建议使用 Pipedream 的远程 MCP 服务器。

推荐：使用 Pipedream 的远程 MCP 服务器

为了获得最佳体验，请使用 Pipedream 托管的 MCP 服务器，它提供以下功能：

• 2,800+ API 和 10,000+ 工具，通过单一服务器访问
• 内置身份验证：无需手动管理令牌
• 多种工具模式：子代理和完整配置
• 自动应用发现
• 企业级可靠性和安全性

🚀 开始使用：Pipedream MCP 文档

🎮 立即尝试：查看我们的开源聊天应用，访问 chat.pipedream.com

自托管（参考实现）

此参考实现展示了如何：

• 在本地运行服务器，使用 npx @pipedream/mcp
• 自托管服务器，以便在您的应用或公司内部使用

您可以在 mcp.pipedream.com 查看面向消费者的 MCP 服务器，并在 chat.pipedream.com 查看面向开发者的产品演示。

我们发布此代码作为参考，以便您更好地了解如何在类似应用中使用 Pipedream Connect。这是专门用于自托管服务器的参考实现，可能未完全记录。

对于生产环境，我们强烈建议使用我们的远程 MCP 服务器。

⭐ 参考实现功能

• 为超过 2,800 个应用和 API 运行您自己的 MCP 服务器
• 在您自己的应用中为您的用户管理服务器
• 通过工具连接账户、配置参数并发出 API 请求
• 完全托管的 OAuth 和凭证存储（查看安全文档）

🚀 开始使用

Pipedream 的 MCP 服务器使用 Pipedream Connect API 来管理身份验证并发出 API 请求。要运行 MCP 服务器，您需要一个 Pipedream 项目和 Pipedream API 凭证。

1. 注册 Pipedream
2. 创建一个项目。通过 MCP 连接的任何账户都将存储在此处。
3. 创建一个 Pipedream OAuth 客户端
4. 设置环境变量（参见 .env.example）（直接在您的 shell 会话、dot 文件等中）：

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 服务器接受两个路由参数：

1. external_user_id — 这是您系统中用户的 ID，无论您使用什么来唯一标识他们。对该路由发出的任何请求都将与该终端用户绑定，并使用 Pipedream 为该用户存储的身份验证信息。查看文档 了解更多详情。
2. app — 应用的“名称 slug”（应用的唯一标识符），可在 任何 Pipedream 应用 的身份验证部分找到。例如，Slack 的应用 slug 是 slack。

如果您的用户 123 想要连接到 slack MCP 服务器，您的 MCP 客户端将向 /123/slack 路由发出请求。查看下面的 SSE 文档 了解更多详情。

服务器概述

有两种方式使用此 MCP 服务器。

1 - 应用特定 /{external_user_id}/{app} 目前可在 mcp.pipedream.com 使用。您可以为每个应用使用一个端点。 该应用的所有可用工具都将在此端点提供。

2 - 动态 /{external_user_id} 这是一个实验性版本，因为它依赖于工具能够动态更新。 我们使用此服务器为 chat.pipedream.com 上的工具提供支持。

[!NOTE] > 查看文档 了解更多关于使用 MCP 服务器启用应用发现的信息。

自托管服务器

使用 Dockerfile

如果您在本地安装了 Docker，可以构建并运行容器：

> docker build -t pipedream-connect .
> docker run -d --name pd-mcp -p 3010:3010 --env-file .env pipedream-connect:latest

这将暴露一个通用的 MCP 服务器，地址为 http://localhost:3010/:external_user_id/:app。

开发

cp .env.example .env 并填写您的开发项目详细信息。

pnpm install

使用 Streamable HTTP 传输启动服务器

pnpm dev:http

您可以使用可选的环境变量 PD_SDK_DEBUG 来打印所有发送到 Connect API 的请求和响应

PD_SDK_DEBUG=true pnpm dev:http

然后运行检查器：

npx @modelcontextprotocol/inspector

使用 http://localhost:3010/v1/{external_user_id}/{app} 进行 Streamable HTTP 传输，或使用 http://localhost:3010/{external_user_id}/{app} 进行 SSE 传输。

这些 URL 也可以被其他客户端（例如 Cursor）使用。

Stdio 传输设置

Stdio 仅与 MCP 检查器一起测试过。

npx @modelcontextprotocol/inspector bun src/stdio.ts

查看检查器的 URL 日志。

确保检查器的左侧匹配以下内容： Screenshot 2025-03-12 at 1 05 37 PM 然后按“List Tools”获取 MCP 工具列表。

许可证

Pipedream 源可用许可证版本 1.0 - 参见 https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE