MCP-Turso

by nbbaier
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Turso-hosted LibSQL databases, allowing retrieval of table lists, database schemas, table schemas, and execution of SELECT queries.

mcp-turso

TursoがホストするLibSQLデータベースへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。現在、このサーバーは以下の機能を提供しています。

  • データベース内のテーブルのリストを取得する
  • データベーススキーマを取得する
  • テーブルのスキーマを取得する
  • SELECTクエリの実行

構成

クロード・デスクトップ

これをclaude_desktop_config.jsonに追加します:

{ "mcpServers": [ "turso": { "command": "npx", "args": ["-y", "mcp-turso"], "env": { "TURSO_DATABASE_URL": "your_url", "TURSO_AUTH_TOKEN": "your_token" } } ] }

続行するには既存のデータベースが必要です。データベースがない場合は作成してください。Turso CLI 経由でデータベース URL を取得するには、次のコマンドを実行します。

turso db show --url <database-name>

次に、データベース認証トークンを取得します。

turso db tokens create <database-name>

上記のように、これらの値を構成に追加します。

ログ記録

サーバーには、Claude Desktop 外部でのデバッグ用にカスタムロガーが含まれています。デフォルトでは、このロガーは<parent-dir>/logs/mcp-turso.logに書き込みます。ここで、 <parent-dir>mcp-tursoスクリプトを含むディレクトリの親ディレクトリです。つまり、 mcp-tursoへのパスが~/foo/bin/mcp-tursoの場合、ログは~/foo/logs/mcp-turso.logに書き込まれます。上記のように NPX で実行している場合、デフォルトのログは次のようになります。

~/.npm/_npx/<npx-dir-name>/node_modules/mcp-turso/logs/mcp-turso.log

カスタム パスを指定する場合は、サーバーの構成に絶対 POSIX パスを含む--logsフラグを含めることができます。

{ "mcpServers": [ "turso": { "command": "npx", "args": ["-y", "mcp-turso", "--logs", "/Users/<username>/path/to/dir/mcp-logs.log"], "env": { "TURSO_DATABASE_URL": "your_url", "TURSO_AUTH_TOKEN": "your_token" } } ] }

ログファイルへのパス(デフォルトまたはカスタム)は、サーバー作成時に常にstderrに記録されます。Claudeデスクトップ版の場合、これは~/Library/Logs/Claude内のサーバーログに表示されます。

: 現時点では、Windows 用のカスタム ログ ファイルの指定は実装されていませんが、今後実装される予定です。

サーバー機能

サーバーは次のツールを提供します。

  • list_tables
    • データベース内のすべてのテーブルのリストを取得する
    • 入力なし
    • 戻り値: テーブル名の配列
  • get_db_schema
    • データベース内のすべてのテーブルのスキーマを取得する
    • 入力なし
    • 戻り値: SQL作成ステートメントの配列
  • describe_table
    • 特定のテーブルのスキーマ情報を表示する
    • 入力: - table_name (文字列): 記述するテーブルの名前
    • 戻り値: 名前と型を持つ列定義の配列
  • query
    • SELECTクエリを実行してデータベースからデータを読み取ります
    • 入力:
      • query (文字列): 実行するSELECT SQLクエリ
    • 戻り値: クエリ結果{ columns: string[]; rows: Record<string, unknown>[]; rowCount: number; }型のオブジェクトとして返します。

藤堂

  • [ ] Windowsでカスタムログファイルを指定する機能を追加
  • [ ] クエリツールを追加する

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude に Turso がホストする LibSQL データベースへのアクセスを提供し、データベース テーブルの一覧表示、スキーマの取得、および SELECT クエリの実行を可能にするモデル コンテキスト プロトコル サーバー。

  1. Configuration
    1. With Claude Desktop
    2. Logging
  2. Server Capabilities
    1. Todo
      1. License
        ID: r0ersuisw0