Didlogic MCP Server

Didlogic MCP サーバー

Didlogic API 向けの Model Context Protocol（MCP）サーバー実装です。このサーバーを使用すると、LLM は標準化されたインターフェースを通じて Didlogic サービスを利用できます。

機能

• MCP ツールを通じた Didlogic API への完全なアクセス
• 一般的な操作向けの専用プロンプト
• 残高管理ツール
• SIP アカウント（sipfriends）の管理
• IP 制限の管理
• 購入の管理
• 通話履歴へのアクセス
• 取引履歴へのアクセス

インストール

uv を使用する（推奨）

uv を使用する場合、特別なインストールは必要ありません。
uvx を使用して didlogic_mcp を直接実行します。

PIP を使用する

または、pip を使用して didlogic_mcp をインストールできます。

pip install didlogic_mcp

インストール後、次のコマンドをスクリプトとして実行できます。

DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp

トランスポートモード

このサーバーは 3 つのトランスポートモードに対応しています。

STDIO モード（デフォルト）

Claude Desktop などのツールとローカルで連携するためのモードです。認証には DIDLOGIC_API_KEY 環境変数を使用します。

# Using uvx (recommended)
DIDLOGIC_API_KEY=your_key uvx didlogic_mcp

# Using uv run
DIDLOGIC_API_KEY=your_key uv run didlogic_mcp

# As Python module
DIDLOGIC_API_KEY=your_key python -m didlogic_mcp --transport stdio

HTTP モード

リモートアクセスとウェブクライアント向けのモードです。各リクエストの Authorization ヘッダーに Bearer トークンが必要です。

# Using default port (8000)
python -m didlogic_mcp --transport http

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport http

# Custom host and port
python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport http --log-level DEBUG

環境変数：

• PORT - サーバーのポート（デフォルト：8000）
• DIDLOGIC_API_URL - Didlogic API のベース URL（デフォルト：https://app.didlogic.com/api）

注： HTTP モードでは、クライアントは Authorization ヘッダーに API キーを Bearer トークンとして指定する必要があります。

SSE モード（Server-Sent Events）

永続的な接続でストリーミング通信を行うためのモードです。リアルタイム更新やストリーミングのシナリオに最適です。各リクエストの Authorization ヘッダーに Bearer トークンが必要です。

# Using default port (8000)
python -m didlogic_mcp --transport sse

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport sse

# Custom host and port
python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport sse --log-level DEBUG

環境変数：

• PORT - サーバーのポート（デフォルト：8000）
• DIDLOGIC_API_URL - Didlogic API のベース URL（デフォルト：https://app.didlogic.com/api）

注： SSE モードでは、永続的なストリーミング接続を確立するため、クライアントは Authorization ヘッダーに API キーを Bearer トークンとして指定する必要があります。

設定

Claude.app の設定

Claude の設定に追加します。

uvx を使用する

"mcpServers": {
  "didlogic": {
    "command": "uvx",
    "args": ["didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

pip でインストールする

"mcpServers": {
  "didlogic": {
    "command": "python",
    "args": ["-m", "didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Claude Code の設定

Claude Code では、稼働中の SSE サーバーインスタンスに接続できます。

claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer YOUR_DIDLOGIC_API_KEY"

前提条件：

1. SSE モードでサーバーを起動します：python -m didlogic_mcp --transport sse
2. 上記のコマンドを実行し、YOUR_DIDLOGIC_API_KEY を実際の API キーに置き換えます
3. サーバーが稼働中で、指定した URL からアクセスできる必要があります

カスタム設定：

• 別のポートを使用するには、http://localhost:8000/sse をサーバーの PORT 設定に合わせて変更します
• リモートサーバーに接続するには、localhost をサーバーのホスト名または IP アドレスに置き換えます

ライセンス

MIT