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>

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

カーソル付き

Cursor を使用して Turso MCP サーバーを構成するには、Cursor 設定に以下を追加します。

1. カーソルを開き、設定 (⚙️) > 設定 (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デスクトップ版の場合、これは~/Library/Logs/Claude内のサーバーログに表示されます。

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

Related MCP server: Supabase MCP Server

サーバー機能

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

• list_tables

  • データベース内のすべてのテーブルのリストを取得する

  • 入力なし

  • 戻り値: テーブル名の配列

• get_db_schema

  • データベース内のすべてのテーブルのスキーマを取得する

  • 入力なし

  • 戻り値: SQL作成ステートメントの配列

• describe_table

  • 特定のテーブルのスキーマ情報を表示する

  • 入力：

    • table_name (文字列): 記述するテーブルの名前

  • 戻り値: 名前と型を持つ列定義の配列

• query_database

  • SELECTクエリを実行してデータベースからデータを読み取ります

  • 入力：

    • sql (文字列): 実行するSELECT SQLクエリ

  • 戻り値: クエリ結果{ columns: string[]; rows: Record<string, unknown>[]; rowCount: number; }型のオブジェクトとして返します。

藤堂

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

• [ ] クエリツールを追加する

ライセンス

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