local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables integration with Windsurf IDE (a Codeium product), allowing developers to interact with Dust AI agents directly from their development environment

MCP 먼지 서버

이 저장소에는 Dust 에이전트와 상호 작용하도록 설계된 모델 컨텍스트 프로토콜(MCP) 서버 구현이 포함되어 있습니다. 이 서버는 Dust API 상호 작용을 처리하는 MCP 서버와 테스트를 위한 웹 인터페이스를 제공하는 MCP 테스트 클라이언트의 두 가지 주요 구성 요소로 나뉩니다.

특징

MCP 서버와 테스트 클라이언트 구성 요소를 분리합니다.
Dust API를 통한 Dust AI 에이전트와의 상호 작용
SSE(Server-Sent Events) 및 HTTP 스트림 전송을 사용한 실시간 스트리밍 응답
'initialize', 'message', 'terminate' 및 'run' 메서드를 통해 JSON-RPC 2.0을 완벽하게 지원합니다.
간소화된 클라이언트 통합을 위한 '실행' 방식을 통한 직접 도구 실행
강력한 세션 관리 및 컨텍스트 보존
로그에 PII 마스킹을 적용하여 안전한 API 키 처리
지속적인 연결을 유지하기 위한 하트비트 메커니즘
끊어진 연결에 대한 자동 재연결
포괄적인 오류 처리 및 보고
최신 MCP 사양(2025-03-26) 지원
모니터링 및 상태 확인을 위한 상태 엔드포인트

건축학

MCP Dust Server는 다음 구성 요소를 사용하여 구축되었습니다.

그림 1: 서버 및 클라이언트 구성 요소를 보여주는 MCP 서버 아키텍처

MCP 서버(server.ts) :
- Dust API와 MCP 프로토콜 상호 작용을 처리합니다.
- 세션 상태 및 컨텍스트를 관리합니다.
- 전체 MCP 수명 주기(초기화, 메시지, 종료)를 구현합니다.
- SSE와 HTTP 스트림 전송을 모두 지원합니다
- 모니터링을 위한 상태 엔드포인트를 제공합니다.
MCP 테스트 클라이언트(client.ts) :
- 테스트를 위한 웹 인터페이스를 제공합니다
- MCP 서버와의 상호 작용을 허용합니다.
- 실시간 스트리밍 및 디버깅을 지원합니다
- 세션 관리 및 연결 추적이 포함됩니다.

Dust.tt 에이전트 AI

Dust.tt는 조직의 특정 요구에 맞춰 맞춤형 AI 에이전트를 구축하고 배포할 수 있도록 설계된 플랫폼입니다. GPT-4, Claude, Gemini, Mistral과 같은 고급 AI 모델과 엔터프라이즈급 보안 기능을 통합하여 워크플로를 간소화하고, 작업을 자동화하고, 다양한 비즈니스 기능 전반의 생산성을 향상시킵니다.

그림 2: 에이전트 기능을 보여주는 Dust.tt 플랫폼 인터페이스의 스크린샷

맞춤형 AI 에이전트 : 개인화된 에이전트: 팀이나 개인의 요구 사항에 맞춰 사용자 정의 지침과 도구를 갖춘 에이전트를 만듭니다.

회사 컨텍스트 : 회사 데이터에 원활하게 액세스할 수 있도록 Notion, Slack, GitHub 또는 외부 API와 같은 내부 도구와 에이전트를 통합합니다.

다중 에이전트 워크플로 : 고유한 역량을 갖춘 여러 에이전트를 단일 워크플로로 결합하고 연결합니다.

데이터 소스와의 통합 : 데이터 연결: 에이전트를 SharePoint, Zendesk, Jira, Salesforce, Snowflake 등의 데이터에 연결합니다.

동적 쿼리 : 에이전트를 사용하여 자연어 또는 SQL 쿼리로 스프레드시트, 데이터베이스 및 창고를 분석합니다.

실시간 업데이트 : 최신 응답을 위해 회사 지식을 지속적으로 동기화합니다.

오픈 소스 : MIT 라이선스에 따라 GitHub 에서 제공됩니다. 대규모 사용자 및 개발자 커뮤니티를 보유하고 있습니다.

호스팅 : SaaS 또는 자체 서버에서의 자체 호스팅 옵션

설치

필수 조건

Node.js(권장: nvm을 통해 최신 LTS 버전 설치)
npm(Node.js와 함께 제공)
타입스크립트

단계

저장소를 복제합니다.지엑스피1
종속성 설치:
npm install
환경 변수 구성: .env.example 기반으로 루트 디렉토리에 .env 파일을 만듭니다.
# Startup Mode (server, client, or both) START_MODE=both # MCP Server Configuration MCP_NAME=Dust MCP Server JS MCP_HOST=127.0.0.1 MCP_PORT=5001 MCP_TIMEOUT=30 # seconds # MCP Test Client Configuration CLIENT_HOST=127.0.0.1 CLIENT_PORT=6001 # Dust API Configuration DUST_API_KEY=your_dust_api_key_here DUST_WORKSPACE_ID=your_workspace_id_here DUST_AGENT_ID=your_agent_id_here DUST_DOMAIN=https://dust.tt # User Context Information (used in Dust API requests) DUST_USERNAME=your_username DUST_EMAIL=your_email@example.com DUST_FULLNAME=Your Full Name DUST_TIMEZONE=Europe/Berlin

서버 및 클라이언트 시작

MCP 서버와 테스트 클라이언트를 개별적으로 또는 함께 실행할 수 있습니다. 이 프로젝트는 다양한 시나리오에 맞는 여러 npm 스크립트를 제공합니다.

서버와 클라이언트를 모두 시작합니다 .
npm run start
MCP 서버만 시작 :
npm run start:server
테스트 클라이언트만 시작 :
npm run start:client

예상 출력

모든 것이 올바르게 구성되었다면 다음과 비슷한 출력이 표시되어야 합니다.

MCP 서버의 경우 :

MCP Server running on http://127.0.0.1:5001 (timeout: 30s)
Server name: Dust MCP Bridge
Dust workspace: your_workspace_id
Dust agent: your_agent_id

테스트 클라이언트의 경우 :

MCP Test Client running on http://127.0.0.1:6001

API 엔드포인트

서버는 상태 점검 및 MCP 프로토콜 통신을 위한 여러 엔드포인트를 제공합니다. 자세한 API 문서는 개발자 문서 를 참조하세요.

주요 종료점은 다음과 같습니다.

건강 검진 : /health , /ready , /live
MCP 프로토콜 : /sse (서버에서 보낸 이벤트), /stream (HTTP 스트림 전송)

디버깅

MCP Inspector를 포함한 디버깅 도구와 기술에 대한 자세한 내용은 개발자 문서 를 참조하세요.

연결 문제 해결

MCP Inspector나 다른 클라이언트에서 연결 문제가 발생하는 경우 다음과 같은 일반적인 문제를 확인하세요.

포트 구성 불일치 : .env 파일에 일관된 포트 설정(MCP_PORT, MCP_MIN_PORT, MCP_MAX_PORT)이 있는지 확인하세요.
전송 모드 : stdio 전송을 사용하는 Claude Desktop 또는 MCP Inspector의 경우 .env 에서 TRANSPORT_MODE=stdio 설정합니다.
여러 응답 헤더 : "ERR_HTTP_HEADERS_SENT" 오류가 표시되면 미들웨어가 여러 응답을 보내는지 확인하세요.

포괄적인 문제 해결 가이드는 개발자 문서의 '일반적인 문제 해결' 섹션을 참조하세요.

완성

Windsurf IDE 구성

Dust MCP 서버를 Windsurf IDE와 통합하려면 구성 파일 ~/.codeium/windsurf/mcp_config.json 업데이트하세요.

{
  "mcpServers": {
    "dust-mcp": {
      "command": "npm",
      "args": [
        "run",
        "start:server"
      ],
      "env": {
        "DUST_API_KEY": "${YOUR_API_KEY}",
        "DUST_WORKSPACE_ID": "${YOUR_WORKSPACE_ID}",
        "DUST_AGENT_ID": "${YOUR_AGENT_ID}"
      },
      "host": "127.0.0.1",
      "port": 5001,
      "timeout": 30000
    }
  }
}

Claude 데스크톱 통합

Dust MCP Server를 Claude Desktop과 통합하려면 구성 파일을 업데이트하세요.

{
  "mcpServers": {
    "dust-agent": {
      "command": "npm",
      "args": [
        "run",
        "start:server"
      ],
      "cwd": "path/to/mcp-dust-server",
      "host": "127.0.0.1",
      "port": 5001,
      "timeout": 30000,
      "env": {
        "DUST_API_KEY": "${YOUR_API_KEY}",
        "DUST_WORKSPACE_ID": "${YOUR_WORKSPACE_ID}",
        "DUST_AGENT_ID": "${YOUR_AGENT_ID}"
      }
    }
  }
}

테스트

이 프로젝트에는 웹 기반 테스트 도구와 명령줄 테스트 도구가 모두 포함되어 있습니다. 자세한 테스트 정보는 개발자 문서를 참조하세요.

클라이언트 구성 요소를 실행하면 http://localhost:6001 에서 웹 기반 테스트 클라이언트에 액세스할 수 있으며, 이를 통해 Dust 에이전트와 상호 작용하고 MCP 서버 기능을 테스트할 수 있습니다.

API 개요

서버는 상태 점검 및 MCP 프로토콜 통신을 위한 여러 엔드포인트를 제공합니다. 자세한 API 문서는 개발자 문서 를 참조하세요.

개발자 문서

프로젝트 구조, API 문서, 디버깅 도구, 보안 고려 사항을 포함한 자세한 기술 정보는 개발자 문서 를 참조하세요.

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Dust AI 에이전트와의 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, Windsurf IDE 및 Claude Desktop과 같은 개발 환경과의 통합을 허용합니다.

Appeared in Searches

How to search for Facebook profiles