DB Agent MCP Server

MySQL実行MCP

1. 依存関係

bun install

2. 環境変数設定

.env作成以下環境変数設定

# 設定必須
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASS=root
DB_NAME=appdb

# 設定
PORT=3000

# 認証設定
AUTH_ENABLED=false  # 認証有効場合 true
API_KEY=your-secret-api-key  # 認証有効場合使用API

認証:

• AUTH_ENABLED=false: 認証動作開発環境向
• AUTH_ENABLED=true: 認証有効場合API_KEY設定必須
• 認証有効場合以下方法API含必要
  • Authorization: Bearer <API_KEY>
  • Authorization: ApiKey <API_KEY>
  • X-API-Key: <API_KEY>

3. MySQL起動

docker build -t local-mcp-mysql ./docker/mysql

docker run -d \
  -p 3306:3306 \
  --name mcp-mysql \
  -e MYSQL_ROOT_PASSWORD=root \
  local-mcp-mysql

docker exec -it mcp-mysql mysql -uroot -proot appdb

Docker停止削除

停止場合

docker stop mcp-mysql

停止削除場合

docker stop mcp-mysql
docker rm mcp-mysql

停止削除場合強制削除

docker rm -f mcp-mysql

4. MCP起動

HTTP起動

bun run start

http://localhost:3000/mcp起動変更場合環境変数PORT設定

PORT=8080 bun run start

認証:

• 認証無効AUTH_ENABLED=false
• 本番環境AUTH_ENABLED=true``API_KEY設定認証有効

5. MCP設定

Cursor場合

認証無効場合開発環境:

Cursor設定~/.cursor/mcp.json 設定UI以下追加

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

認証有効場合本番環境:

headers使用API指定以下方法使用

方法1: X-API-Key使用

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "X-API-Key": "your-secret-api-key"
      }
    }
  }
}

方法2: Authorization使用Bearer形式

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-api-key"
      }
    }
  }
}

方法3: Authorization使用ApiKey形式

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "ApiKey your-secret-api-key"
      }
    }
  }
}

Claude Desktop場合

認証無効場合開発環境:

~/Library/Application Support/Claude/claude_desktop_config.json 以下追加

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

認証有効場合本番環境:

headers使用API指定

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "X-API-Key": "your-secret-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "db-agent": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-api-key"
      }
    }
  }
}

重要: MCP起動CursorClaude Desktop再起動

使用方法

MCP以下2使用SQL実行

run_query_readonly - 読取専用承認不要

SELECTSHOWDESCRIBEDESCEXPLAIN実行承認求

例

• SELECT * FROM users LIMIT 10;
• SELECT COUNT(*) FROM sessions;
• SHOW TABLES;
• DESCRIBE users;
• EXPLAIN SELECT * FROM users;

run_query_write - 書込承認必要

INSERTUPDATEDELETECREATEDROPALTER書込操作実行承認求

例

• INSERT INTO users (name, email) VALUES ('John', 'john@example.com');
• UPDATE users SET name = 'Jane' WHERE id = 1;
• DELETE FROM sessions WHERE expired_at < NOW();
• CREATE TABLE products (id INT PRIMARY KEY, name VARCHAR(255));