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": "あなたのデータベース URL",
            "TURSO_AUTH_TOKEN": "あなたの認証トークン"
         }
      }
   ]
}

続行するには既存のデータベースが必要です。ない場合は、こちらから作成できます。Turso CLI を使用してデータベース URL を取得するには、以下のコマンドを実行します：

turso db show --url <database-name>

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

turso db tokens create <database-name>

これらの値を上記の設定に追加してください。

Cursor を使用する場合

Cursor で Turso MCP サーバーを設定するには、以下の手順に従ってください：

1. Cursor を開き、設定 (⚙️) > 設定 (JSON) に移動します。
2. 以下の設定を設定 JSON ファイルに追加します：

"mcpServers": {
  "turso": {
    "command": "npx",
    "args": ["-y", "mcp-turso"],
    "env": {
      "TURSO_DATABASE_URL": "あなたのデータベース URL",
      "TURSO_AUTH_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 パスを指定することで、カスタムログパスを設定できますが、現在 Windows システムでは完全にはサポートされていません。

✨ 主な機能

機能リスト

• list_tables：データベース内のテーブルリストを取得します。
• get_db_schema：データベース全体のスキーマ情報を取得します。
• describe_table：特定のテーブルのスキーマ情報を取得します。
• query_database：任意の SELECT クエリを実行し、結果を返します。

入出力の説明

list_tables

入力：なし
出力：すべてのテーブル名を含むリスト。

get_db_schema

入力：なし
出力：データベース全体のスキーマ情報（テーブル、列、その他の構造を含む）。

describe_table

入力：テーブル名
出力：指定されたテーブルの詳細なスキーマ情報（列名、データ型など）。

query_database

入力：SQL クエリ文
出力：クエリ結果セット（通常は表形式で返されます）。

📋 今後の予定

• Windows システムでのログ記録機能をサポートする。
• より多くのデータベース操作のサポートを追加する。