Pipedream

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 및 자격 증명 저장소( 보안 문서 참조 )

🚀 시작하기

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가 로컬에 설치되어 있으면 컨테이너를 빌드하고 실행할 수 있습니다.

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

개발

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

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

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

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

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

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

Stdio Transport 설정

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

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

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

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

특허

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