mcp-turso

mcp-turso

Turso がホストする LibSQL データベースへのアクセスを提供する Model Context Protocol（MCP）サーバーです。現在、サーバーでは次の機能を利用できます。

• データベース内のテーブル一覧の取得
• データベースのスキーマの取得
• テーブルのスキーマの取得
• SELECT クエリの実行

設定

Claude Desktop の場合

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>

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

Cursor の場合

Cursor で Turso MCP サーバーを設定するには、Cursor の設定に次の内容を追加します。

1. Cursor を開き、Settings（⚙️）> Settings (JSON) に移動します
2. 次の設定を設定 JSON に追加します。

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

前のセクションの説明に従って、your_url と your_token を Turso データベースの URL と認証トークンに置き換えます。

ログ記録

このサーバーには、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 Desktop の場合、~/Library/Logs/Claude にあるサーバーログに表示されます。

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

サーバーの機能

サーバーでは次のツールを利用できます。

• list_tables
  • データベース内のすべてのテーブルの一覧を取得します
  • 入力なし
  • 戻り値：テーブル名の配列
• get_db_schema
  • データベース内のすべてのテーブルのスキーマを取得します
  • 入力なし
  • 戻り値：SQL 作成文の配列
• describe_table
  • 特定のテーブルのスキーマ情報を表示します
  • 入力：
    • table_name（string）：説明するテーブルの名前
  • 戻り値：名前と型を含む列定義の配列
• query_database
  • データベースからデータを読み取る SELECT クエリを実行します
  • 入力：
    • sql（string）：実行する SELECT SQL クエリ
  • 戻り値：{ columns: string[]; rows: Record<string, unknown>[]; rowCount: number; } 型のオブジェクトとしてのクエリ結果

Todo

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

ライセンス

MIT License — 詳細は LICENSE ファイルを参照してください。