Dixa MCP Server

Dixa MCP 서버

Dixa API를 위한 FastMCP 서버 구현으로, 대화와 태그를 관리하기 위한 리소스와 도구를 제공합니다.

특징

• 자원
  • 대화 검색
  • 대화 세부 정보 가져오기
  • 대화 노트 받기
  • 대화 메시지 받기
  • 사용 가능한 태그 가져오기
• 도구
  • 대화에 태그 추가
  • 대화에서 태그 제거

프로젝트 구조

지엑스피1

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• DIXA_API_KEY : Dixa API 키
• DIXA_API_BASE_URL (선택 사항): 기본 API URL을 재정의합니다(기본값은 ' https://dev.dixa.io/v1 ').

용법

1. 환경 변수 설정:

2. 서버를 시작합니다:
   npm start

이렇게 하면 터미널에서 MCP 서버를 테스트하고 디버깅하기 위해 mcp-cli 로 서버가 실행됩니다.

MCP Inspector 으로 검사하세요

또 다른 방법은 공식 MCP Inspector 사용하여 웹 UI로 서버를 검사하는 것입니다.

자주 묻는 질문

Claude Desktop과 함께 사용하는 방법?

https://modelcontextprotocol.io/quickstart/user 가이드를 따르고 다음 구성을 추가하세요.

개발

새로운 리소스 추가

1. src/schemas/ 에 스키마를 생성합니다.
2. src/resources/ 에 리소스를 생성합니다.
3. src/dixa.ts 에 리소스를 추가합니다.

예시 리소스:

새 도구 추가

1. src/tools/ 에 도구를 생성합니다.
2. src/dixa.ts 에 도구를 추가합니다.

도구 예시:

오류 처리

이 프로젝트에서는 사용자 정의 오류 클래스를 사용합니다.

• DixaError : API 오류에 대한 기본 오류 클래스
• DixaValidationError : 응답 검증 실패 시

유리 진열장

[!메모]

FastMCP를 사용하여 서버를 개발한 적이 있다면, 여기에 PR을 제출하여 소개해주세요!

• https://github.com/apinetwork/piapi-mcp-server
• https://github.com/Meeting-Baas/meeting-mcp - AI 어시스턴트가 회의 봇을 생성하고, 대본을 검색하고, 녹음 데이터를 관리할 수 있도록 하는 Meeting BaaS MCP 서버

감사의 말

• FastMCP는 Jonathan Lowin 의 Python 구현 에서 영감을 받았습니다.
• 코드베이스의 일부는 LiteMCP 에서 채택되었습니다.
• 코드베이스의 일부는 Model Context 프로토콜에서 채택되었습니다.

기여하다

1. 기존 리소스 및 도구 패턴을 따르세요
2. 적절한 JSDoc 문서를 추가하세요
3. types.ts 및 config.ts 의 공유 유틸리티를 사용하세요.
4. 새로운 기능을 추가하는 경우 README를 업데이트하세요.