Dixa MCP サーバー

Dixa API 用の FastMCP サーバー実装。会話とタグを管理するためのリソースとツールを提供します。

特徴

リソース
- 会話を検索
- 会話の詳細を取得する
- 会話メモを取得する
- 会話メッセージを取得する
- 利用可能なタグを取得する
ツール
- 会話にタグを追加する
- 会話からタグを削除する

プロジェクト構造

/src
├── dixa.ts              # Main server setup
├── config.ts            # Configuration and environment settings
├── types.ts             # Shared types and error handling
├── resources/           # Resource implementations
├── schemas/            # Zod schemas for validation
└── tools/             # Tool implementations

構成

サーバーには次の環境変数が必要です。

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`で検査する

もう 1 つの方法は、公式のMCP Inspector使用して Web 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アシスタントが会議ボットを作成したり、トランスクリプトを検索したり、記録データを管理したりできるようにする会議BaaS MCPサーバー

謝辞

FastMCP は、 Jonathan LowinによるPython 実装にインスピレーションを受けています。
コードベースの一部はLiteMCPから採用されました。
コードベースの一部はModel Context プロトコルで SSE をやってみるから採用されました。

貢献

リソースとツールの既存のパターンに従う
適切なJSDocドキュメントを追加する
types.tsとconfig.tsの共有ユーティリティを使用する
新しい機能を追加する場合はREADMEを更新してください