Pipedream MCP 서버

이는 Pipedream MCP 서버의 참조 구현입니다. 2,500개 이상의 앱과 API 에 대해 자체 MCP 서버를 운영할 수 있으며, Pipedream Connect를 기반으로 합니다.

다음을 수행할 수 있습니다.

• npx @pipedream/mcp 사용하여 로컬로 서버를 실행하세요.

• 앱이나 회사 내에서 서버를 직접 호스팅하여 사용하세요.

mcp.pipedream.com 및 chat.pipedream.com 에서 서버가 작동하는 모습을 확인하세요.

이 코드를 참고용으로 게시했으므로, 이러한 애플리케이션에서 Pipedream Connect를 사용하는 방법을 더 잘 이해하실 수 있습니다. 이 코드는 아직 개발 중이며 완전히 문서화되지 않았습니다. 궁금한 점이 있으시면 언제든지 문의해 주세요.

⭐ 특징

• 2,500개 이상의 앱과 API 에 대해 자체 MCP 서버를 실행하세요

• 귀하의 앱에서 사용자의 서버를 관리하세요.

• 도구를 통해 계정 연결, 매개변수 구성 및 API 요청 수행

• 완전 관리형 OAuth 및 자격 증명 저장소( 보안 문서 참조 )

Related MCP server: Integrations MCP

🚀 시작하기

Pipedream의 MCP 서버는 Pipedream Connect API를 사용하여 인증을 관리하고 API 요청을 수행합니다. MCP 서버를 실행하려면 Pipedream 프로젝트와 Pipedream API 사용자 인증 정보가 필요합니다.

1. Pipedream에 가입하세요

2. 프로젝트를 생성하세요 . MCP를 통해 연결된 모든 계정이 여기에 저장됩니다.

3. Pipedream OAuth 클라이언트 만들기

4. 환경 변수를 설정합니다(셸 세션, dot 파일 등에서 직접). ( .env.example 참조)

지엑스피1

이해하기 위한 파이프드림 개념

앱에 MCP 서버를 사용하는 경우 SSE 인터페이스를 사용하는 것이 좋습니다. SSE 서버는 두 가지 경로 매개변수를 허용합니다.

1. external_user_id — 시스템에서 사용자의 ID입니다. 사용자를 고유하게 식별하는 데 사용하는 ID입니다. 해당 경로에 대한 모든 요청은 해당 최종 사용자와 연결되며, Pipedream에서 해당 사용자에 대해 저장한 인증을 사용합니다. 자세한 내용은 문서를 참조하세요 .

2. app — 앱의 "이름 슬러그"(앱의 고유 식별자)로, 모든 Pipedream 앱 의 인증 섹션에서 찾을 수 있습니다. 예를 들어 Slack 의 앱 슬러그는 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 서버에 대한 코드는 이 리포지토리에서 사용할 수 있지만 내부 DB에 의존하므로 아직 로컬에서 실행할 수 없습니다.

직접 실행하고 싶으시면 알려주시기 바랍니다.

자신의 서버 호스팅

Dockerfile 사용하기

Docker가 로컬에 설치되어 있으면 컨테이너를 빌드하고 실행할 수 있습니다.

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

이는 http://localhost:3010/:external_user_id/:app 에서 일반 MCP 서버를 노출합니다.

개발

cp .env.example .env 입력하고 개발 프로젝트의 세부 정보를 입력하세요.

pnpm install

Streamable HTTP Transport로 서버를 시작합니다.

pnpm dev:http

Connect API로 가는 모든 요청과 응답을 출력하려면 선택적 환경 변수 PD_SDK_DEBUG 사용할 수 있습니다.

PD_SDK_DEBUG=true pnpm dev:http

그런 다음 검사기를 실행합니다.

npx @modelcontextprotocol/inspector

스트리밍 가능한 HTTP 전송의 경우 http://localhost:3010/v1/{external_user_id}/{app} 사용하고 SSE 전송의 경우 http://localhost:3010/{external_user_id}/{app} 사용하세요.

이러한 URL은 다른 클라이언트(예: Cursor)에서도 사용할 수 있습니다.

Stdio Transport 설정

Stdio는 MCP Inspector로만 테스트되었습니다.

npx @modelcontextprotocol/inspector bun src/stdio.ts

검사기 URL에 대한 로그를 확인하세요.

검사기의 왼쪽이 다음과 일치하는지 확인하세요.

그런 다음 "도구 목록"을 눌러 MCP 도구 목록을 가져옵니다.

특허

Pipedream 소스 사용 가능 라이센스 버전 1.0 - https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE를 참조하세요.