Dixa MCP 서버

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

특징

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

프로젝트 구조

지엑스피1

구성

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

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

용법

환경 변수 설정:

   export DIXA_API_KEY='your-api-key'

서버를 시작합니다:
npm start

## Running Your Server

### Test with `mcp-cli`

The fastest way to test and debug your server is with `fastmcp dev`:

```bash
npx fastmcp dev server.js
npx fastmcp dev server.ts

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

`MCP Inspector` 으로 검사하세요

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

npx fastmcp inspect server.ts

자주 묻는 질문

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

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

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "tsx",
        "/PATH/TO/YOUR_PROJECT/src/index.ts"
      ],
      "env": {
        "YOUR_ENV_VAR": "value"
      }
    }
  }
}

개발

새로운 리소스 추가

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

예시 리소스:

export const myResource = {
  uri: "dixa://my-resource",
  name: "My Resource",
  description: "Description",
  load: async (args: MyArgs, apiKey: string) => {
    // Implementation
  }
};

새 도구 추가

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

도구 예시:

export const myTool = {
  name: "My Tool",
  description: "Description",
  execute: async (args: MyArgs, apiKey: string) => {
    // Implementation
  }
};

오류 처리

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

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 프로토콜에서 채택되었습니다.

기여하다

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