Dixa

🚀 Dixa MCP サーバー

Dixa API MCPサーバーの高速実装で、会話とタグの管理に必要なリソースとツールを提供します。

✨ 主な機能

リソース

• 会話を検索する
• 会話の詳細を取得する
• 会話のノートを取得する
• 会話のメッセージを取得する
• 利用可能なタグを取得する

ツール

• 会話にタグを追加する
• 会話からタグを削除する

📚 プロジェクト構造

/src
├── dixa.ts             # メインサーバー設定
├── config.ts           # 設定と環境設定
├── types.ts            # 共有型とエラー処理
├── resources/          # リソースの実装
├── schemas/           # 検証用のZodスキーマ
└── tools/             # ツールの実装

📦 インストール

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

• 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

高度な使用法

mcp-cli を使用したテスト

最も簡単なサーバーのテストとデバッグ方法は、 fastmcp dev を使用することです。

npx fastmcp dev server.js
npx fastmcp dev server.ts

これにより、mcp-cli を使用して、ターミナルでMCPサーバーをテストおよびデバッグできます。

MCP Inspector を使用した確認

もう1つの方法は、公式の MCP Inspector を使用して、Web UI でサーバーを確認することです。

npx fastmcp inspect server.ts

📚 詳細ドキュメント

よくある質問

Claude Desktop との使用方法は？

ガイド リンク を参照し、設定に以下を追加してください。

{
  "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: "我的资源",
  description: "描述",
  load: async (args: MyResourceArgs, props: MyResourceProps) => {
    // 実装ロジック
  }
}

新しいツールの追加

1. src/tools/ でツールを作成します。
2. src/dixa.ts にツールを追加します。

ツールの例：

export const myTool = {
  name: "我的工具",
  description: "这是一个用于执行特定任务的工具。",
  args: {
    type: "object" as const,
    properties: {
      // パラメータを定義する
    }
  },
  fn: async (args: MyToolArgs, props: MyToolProps) => {
    // 実装ロジック
  }
}

展示

• Project A：Dixa MCPサーバーの使用方法を示すプロジェクトです。
• Project B：Dixa APIの統合を示す別のプロジェクトです。

謝辞

以下のプロジェクトの貢献に感謝します。

• FastMCPプロジェクト（リンク）は、私たちの実装の基礎を提供しました。
• Zodライブラリ（リンク）は、データ検証と型安全に使用されます。

コントリビューションガイド

コミュニティからの貢献を歓迎します！ 以下の手順に従って参加してください。

1. 問題報告：GitHubリポジトリ で、遭遇した問題や機能要求を提出してください。
2. 機能実装：Issues タグを確認し、実装が必要な機能を見つけて開発してください。
3. コードレビュー：Pull Requestのレビューに積極的に参加し、コードの品質と一貫性を確保してください。
4. ドキュメント貢献：ドキュメントを改善し、より明確で理解しやすくするのを支援してください。

Pull Requestを提出する前に、コントリビューションガイド を読んで詳細を確認してください。