Dixa MCP 서버

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

특징

• 자원

  • 대화 검색

  • 대화 세부 정보 가져오기

  • 대화 노트 받기

  • 대화 메시지 받기

  • 사용 가능한 태그 가져오기

• 도구

  • 대화에 태그 추가

  • 대화에서 태그 제거

Related MCP server: ReActMCP Web Search

프로젝트 구조

지엑스피1

구성

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

• DIXA_API_KEY : Dixa API 키

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

용법

1. 환경 변수 설정:

   export DIXA_API_KEY='your-api-key'

2. 서버를 시작합니다:

   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"
      }
    }
  }
}

개발

새로운 리소스 추가

1. src/schemas/ 에 스키마를 생성합니다.

2. src/resources/ 에 리소스를 생성합니다.

3. src/dixa.ts 에 리소스를 추가합니다.

예시 리소스:

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

새 도구 추가

1. src/tools/ 에 도구를 생성합니다.

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

기여하다

1. 기존 리소스 및 도구 패턴을 따르세요

2. 적절한 JSDoc 문서를 추가하세요

3. types.ts 및 config.ts 의 공유 유틸리티를 사용하세요.

4. 새로운 기능을 추가하는 경우 README를 업데이트하세요.