de en es ja ko ru zh

LiveKit MCP Server

Name: LiveKit MCP Server
Author: FardeenSK004

by FardeenSK004

Overview Schema Related Servers Score Discussions

Python

Remote

LiveKit MCP サーバー

Python MCP Code style: ruff Tests

AIエージェントとMantraCare LiveKit Voice & Telephony Engineを橋渡しする、高性能なModel Context Protocol（MCP 2.0）サーバーです。

アーキテクチャ • クイックスタート • 設定 • クライアントの接続 • 認証 • ツール • 開発

📖 概要

LiveKit MCP Server は、LLMやAIコーディングアシスタント（Antigravity、Claude、Cursor、カスタムエージェントなど）が、LiveKit（~/lkt）を利用した音声テレフォニーパイプラインを安全に制御・検査・トリガーし、Mantra Auth（~/mantra-auth）を介して認証できるようにします。

主な機能

🚀 MCP 2.0 準拠: 公式 Python mcp SDK をベースとし、Server-Sent Events (SSE) と Streamable HTTP トランスポートを使用。
🔐 OAuth 2.1 & 共有 JWT セキュリティ: mantra-auth に一致するネイティブなHS256 JWT検証。Authorization: Bearer ヘッダーと ?token= クエリパラメータの両方をサポート。
⚡ 超高速非同期コア: Starlette、Uvicorn、uv パッケージ管理を採用。
🧩 モジュール式ツールアーキテクチャ: テレフォニー、通話分析、ナレッジベース検索、SIPトランキング用にドメイン分離されたツール。
🧠 エージェントメモリ: 完全な Obsidian ナレッジベース(obsidian/)と AGENTS.md ルールにより、AIペアプログラミングのコンテキストを保持します。

Related MCP server: Agent Identity MCP Server

🏛️ システムアーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│ AI Client (Cursor / Claude / Antigravity / Web Agent)       │
└──────────────────────────────┬──────────────────────────────┘
                               │ 1. Bearer Token / ?token= (OAuth 2.1)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ [3. mantra-auth (:3000)]                                    │
│ Next.js + Prisma OAuth 2.1 Authorization Server             │
│ - Issues HS256 JWTs and verifies via /api/oauth/introspect  │
└──────────────────────────────┬──────────────────────────────┘
                               │ Shared JWT Secret Verification
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ [2. livekit-mcp (:8000)] (This Server)                      │
│ - Starlette ASGI + MCP 2.0 SSE Transport                    │
│ - Pure ASGI Auth Middleware (HS256 JWT validation)          │
│ - Public Endpoints: /health, /                              │
│ - Protected Endpoints: /sse, /messages                      │
│ - Registered Tools: greet_user, [Telephony/KB/SIP coming]   │
└──────────────────────────────┬──────────────────────────────┘
                               │ 2. Async HTTP (REST)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ [1. lkt (:8081)]                                            │
│ MantraCare LiveKit Voice Agent & Telephony Engine           │
│ - SIP Trunks (Plivo, Zadarma, VoiceLink, Twilio)            │
│ - LiveKit Cloud WebRTC Rooms & STT→LLM→TTS Voice Pipeline   │
│ - PostgreSQL (call_logs, kb_pages) & Redis (queues, locks)  │
└─────────────────────────────────────────────────────────────┘

📁 リポジトリ構成

livekit-mcp/
├── .env.example                # Sample environment variables
├── .gitignore                  # Git ignore definitions
├── .python-version             # Python version pin (3.11)
├── AGENTS.md                   # Agent Memory instructions
├── dev.sh                      # Development startup script
├── pyproject.toml              # UV package specification & build settings
├── uv.lock                     # Deterministic lockfile
├── README.md                   # Project documentation
│
├── obsidian/                   # Permanent Agentic Knowledge Base
│   ├── Home.md                 # Project navigation hub
│   ├── Architecture/           # System design, data flow, security & APIs
│   ├── Context/                # Stack, project summary & repository map
│   ├── Development/            # Sprint tracking, TODO & Changelog
│   ├── Features/               # Feature specifications (tools, auth)
│   └── Knowledge/              # Coding standards & architectural conventions
│
├── src/
│   └── livekit_mcp/
│       ├── __init__.py
│       ├── config.py           # Pydantic Settings & environment validation
│       ├── server.py           # MCPServer & Starlette app factory
│       ├── main.py             # CLI runner with Uvicorn
│       ├── auth/
│       │   ├── __init__.py
│       │   ├── jwt.py          # HS256 JWT decoding & claims validation
│       │   └── middleware.py   # Pure ASGI auth middleware (headers & ?token=)
│       ├── clients/
│       │   ├── __init__.py
│       │   ├── lkt_client.py   # Async HTTP client for lkt FastAPI (:8081)
│       │   └── auth_client.py  # Async HTTP client for mantra-auth (:3000)
│       └── tools/
│           ├── __init__.py
│           └── greeting.py     # Initial `greet_user` verification tool
│
└── tests/
    ├── __init__.py
    ├── conftest.py             # Fixtures for tokens, settings & test client
    ├── test_config.py          # Configuration unit tests
    ├── test_auth.py            # JWT verification & claims unit tests
    ├── test_greeting.py        # Tool registration & execution tests
    └── test_server.py          # Endpoints, SSE & Auth integration tests

🚀 クイックスタート

1. 前提条件

Python: 3.11 以上
uv: 高速な Python パッケージマネージャー (uv のインストール)
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```

2. インストールとセットアップ

リポジトリをクローンしてディレクトリに入ります：
```
cd ~/livekit-mcp
```
環境設定ファイルを作成します：
```
cp .env.example .env
```
uv で依存関係をインストールします：
```
uv sync
```

3. サーバーの起動

自動リロード付きで開発サーバーを起動します：

./dev.sh

または、uv を使って直接実行します：

uv run python -m livekit_mcp.main

サーバーは http://localhost:8000 で利用可能になります。

⚙️ 設定

すべての設定は src/livekit_mcp/config.py で pydantic-settings を使用して管理され、.env から読み込まれます。

変数	型	デフォルト	説明
`HOST`	string	`0.0.0.0`	サーバーのバインドアドレス
`PORT`	integer	`8000`	サーバーの待受ポート
`ENVIRONMENT`	string	`development`	`development`、`test`、または `production`
`LOG_LEVEL`	string	`INFO`	ログレベル (`DEBUG`、`INFO`、`WARNING`、`ERROR`)
`AUTH_ENABLED`	boolean	`true`	保護されたエンドポイントでJWT認証を強制する
`JWT_SECRET`	string	`your-super-secret-...`	HS256 JWT 署名検証用の共有シークレットキー
`JWT_ALGORITHM`	string	`HS256`	JWT 署名アルゴリズム（`mantra-auth` と一致）
`AUTH_SERVER_URL`	string	`http://localhost:3000`	Mantra Auth サーバーのベースURL
`JWT_ISSUER`	string	`http://localhost:3000`	期待されるJWT発行者クレーム（`iss`）
`JWT_AUDIENCE`	string	(空)	期待されるオーディエンスクレーム（`aud`）
`LKT_API_BASE_URL`	string	`http://localhost:8080`	LKT Voice Agent API のベースURL
`LKT_API_TIMEOUT`	float	`15.0`	LKT API へのHTTPリクエストのタイムアウト（秒）
`LIVEKIT_URL`	string	(空)	LiveKit Cloud の WebSocket URL
`LIVEKIT_API_KEY`	string	(空)	LiveKit Cloud API キー
`LIVEKIT_API_SECRET`	string	(空)	LiveKit Cloud API シークレット

📡 エンドポイント

エンドポイント	メソッド	認証必須	説明
`/health`	`GET`	❌ いいえ	サービスステータスと依存関係の健全性を確認する公開エンドポイント
`/`	`GET`	❌ いいえ	サービス情報と設定
`/messages`	`POST`	✅ はい	MCP ツール呼び出しのための JSON-RPC エンドポイント
`/mcp`	`GET`	✅ はい	MCP のStreamable HTTPトランスポートエンドポイント

ヘルスチェック例

curl http://localhost:8000/health

{
  "status": "healthy",
  "service": "livekit-mcp",
  "version": "0.1.0",
  "auth_enabled": true,
  "environment": "development",
  "lkt_api_configured": true,
  "timestamp": "2026-08-20T12:30:00.000000+00:00"
}

🔐 認証

サーバーは、mantra-auth と互換性のある OAuth 2.1 & 共有 JWT 認証 を実装しています。

認証情報の提供

Authorization ヘッダー（標準）:

GET /sse HTTP/1.1
Host: localhost:8000
Authorization: Bearer <your-jwt-access-token>

クエリパラメータ（SSE / EventSource クライアント用）:
```
GET /sse?token=<your-jwt-access-token> HTTP/1.1
Host: localhost:8000
```

期待される JWT クレーム

{
  "sub": "user-123",
  "aud": "client-app",
  "iss": "http://localhost:3000",
  "exp": 1755694800,
  "iat": 1755691200,
  "scope": "openid profile telephony:call",
  "token_type": "access_token"
}

開発時のヒント: ローカルテスト中は、.env 内で AUTH_ENABLED=false に設定するとトークン検証を無効化できます。

🛠️ 利用可能なツール

1. `greet_user`

認証、パラメータ解析、サーバー状態を検証するためのシンプルなテストツールです。

パラメータ:
- name (文字列, 必須): ツールを呼び出すユーザーまたはエージェントの名前。
- message (文字列, 任意): カスタム挨拶メッセージ。

戻り値:

👋 Hello, Alice!

Welcome to MantraCare LiveKit MCP!

--- System Status ---
• Service: LiveKit MCP Server
• Status: Operational & Ready
• Timestamp: 2026-08-20T12:30:00.000000+00:00
• Protocol: MCP 2.0 (SSE / HTTP)

🔌 MCP クライアントの接続

1. Antigravity / Gemini CLI (`~/.gemini/config/mcp.json`)

{
  "mcpServers": {
    "livekit": {
      "serverUrl": "http://localhost:8000/sse"
    }
  }
}

2. Cursor IDE (`.cursor/mcp.json`)

{
  "mcpServers": {
    "livekit": {
      "url": "http://localhost:8000/sse",
      "headers": {
        "Authorization": "Bearer <YOUR_JWT_TOKEN>"
      }
    }
  }
}

3. Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "livekit": {
      "command": "uv",
      "args": [
        "--directory",
        "/home/fardeen/livekit-mcp",
        "run",
        "python",
        "-m",
        "livekit_mcp.main"
      ],
      "env": {
        "AUTH_ENABLED": "false"
      }
    }
  }
}

🧪 開発とテスト

テストの実行

このプロジェクトには、設定、JWT検証、ミドルウェア、ツールをカバーする包括的なテストスイートが含まれています:

uv run pytest -v

コードフォーマットとリンティング

ruff を使用してクリーンなコーディング標準を適用します:

# Check code
uv run ruff check .

# Auto-fix issues & format
uv run ruff check --fix .
uv run ruff format .

新しいツールの追加

新しいツールを livekit-mcp に追加するには:

src/livekit_mcp/tools/<domain>.py にモジュールを作成します。

モジュール内でツールを定義します:

from mcp.server.mcpserver import MCPServer

def register_telephony_tools(server: MCPServer) -> None:
    @server.tool(name="trigger_call", description="Trigger an outbound call")
    async def trigger_call(phone_number: str, prompt: str) -> str:
        # Call LktClient here
        return f"Call initiated to {phone_number}"

create_mcp_server() 内の src/livekit_mcp/server.py に関数を登録します。

📚 ナレッジベース

このプロジェクトは、AI ペアプログラミングのコンテキストを提供するために、AGENTS.md ファイルと完全な Obsidian ナレッジベース (obsidian/) を維持しています:

obsidian/Home.md — プロジェクトのホーム
obsidian/Architecture.md — システムアーキテクチャのドキュメント
obsidian/Development.md — 開発プロセスとガイドライン
obsidian/Knowledge.md — ドメイン知識とベストプラクティス

📄 ライセンス

This server cannot be installed

license - not found

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

@chargebee/mcpofficial
Databases Documentation Access Developer Tools
chargebee
A
license
A
quality
F
maintenance
MCP Server that connects AI agents to Chargebee Platform.
Updated 9 months ago (2025-11-18 10:04 UTC)
2
73
15
MIT
Agent Identity MCP Server
Security Autonomous Agents
AiAgentKarl
A
license
Not graded
quality
D
maintenance
MCP Server for AI agent identity and authorization. Create, verify, and manage agent identities with trust scores and scoped authorization tokens.
Updated 5 months ago (2026-04-03 16:05 UTC)
MIT
Smallest MCP Serverofficial
AI & Machine Learning Communication
smallest-inc
A
license
A
quality
A
maintenance
MCP server for the Smallest AI platform that enables managing AI voice agents, debugging calls, and viewing analytics directly from your IDE.
Updated 17 days ago (2026-08-06 07:43 UTC)
83
266
1
MIT
enterprise-auth-mcp-server
Security Developer Tools
AiAgentKarl
A
license
A
quality
D
maintenance
MCP server for enterprise authentication and authorization — JWT validation, OIDC token inspection, OAuth 2.0 introspection, and role-based access control for AI agents.
Updated 5 months ago (2026-04-06 08:37 UTC)
8
MIT

View all related MCP servers

Related MCP Connectors

Hail
Phone, SMS & email for AI agents — one remote MCP endpoint, OAuth login, zero install.
secureflows-mcp-server
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
pAIchart MCP Hub
MCP Hub: AI service discovery, per-user OAuth, and multi-service workflow orchestration

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FardeenSK004/livekit-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server