Mysql Database Service

🚀 MySQLデータベースMCPサービス

このサービスはMCP（モデルコンテキストプロトコル）に基づいており、Cursorを通じてMySQLデータベースとのやり取りを可能にし、テーブルの作成、クエリ、変更、削除などの操作を実行できます。

✨ 主な機能

• データベーステーブルの作成と管理
• CRUD操作（作成、読み取り、更新、削除）の実行
• カスタムSQLクエリの実行
• MCPプロトコルを通じたCursorとの統合

📦 インストール

前提条件

• Node.js 18.0.0以上
• MySQLデータベースサーバー

インストール手順

1. このリポジトリをクローンまたはダウンロードします。
2. 依存関係をインストールします。

npm install

3. 環境変数を設定します。
   • .env.example ファイルを .env としてコピーします。
   • .env ファイルを編集し、MySQLデータベースの接続情報を入力します。

# データベース設定
DB_HOST=localhost
DB_PORT=3006
DB_USER=あなたのデータベースユーザー名
DB_PASSWORD=あなたのデータベースパスワード
DB_NAME=あなたのデータベース名

# サーバー設定
PORT=3001

サービスの起動

npm start

サーバーは http://localhost:3001 （または .env で指定したポート）で起動します。

💻 使用例

Cursorでの使用方法

1. Cursorで、以下の方法でMCPサービスを追加します。
   • 方法1: コマンドパネルで "MCP" を検索し、サービスを追加します。
   • 方法2: 設定でMCP関連の設定を見つけます。
   • 方法3: コマンド /connect-mcp http://localhost:3001/sse を直接使用します。
2. 接続が成功すると、リソースとツールを通じてMySQLデータベースとやり取りできます。

利用可能な機能

リソース

1. すべてのテーブルをリストする

mysql://tables

2. テーブル構造を表示する

mysql://schema/テーブル名

3. テーブルデータを表示する

mysql://data/テーブル名

ツール

1. テーブルを作成する

create-table tableName="テーブル名" schema="id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255)"

2. テーブルを削除する

drop-table tableName="テーブル名"

3. データを挿入する

insert-data tableName="テーブル名" data="{\"name\": \"张三\", \"age\": 30}"

4. データを更新する

update-data tableName="テーブル名" data="{\"name\": \"李四\"}" condition="{\"id\": 1}"

5. データを削除する

delete-data tableName="テーブル名" condition="{\"id\": 1}"

6. データをクエリする

query-data tableName="テーブル名" condition="{\"id\": 1}" fields=["name", "age"]

7. カスタムSQLクエリを実行する

execute-sql sql="SELECT * FROM テーブル名"

提示テンプレート

• create-table: 新しいテーブルを作成します。
• drop-table: 指定されたテーブルを削除します。
• insert-data: テーブルにデータを挿入します。
• update-data: テーブルのデータを更新します。
• delete-data: テーブルからデータを削除します。
• query-data: テーブルのデータをクエリします。
• execute-sql: カスタムSQLクエリを実行します。

サンプルシナリオ

ユーザーテーブルの作成とデータの挿入

1. テーブルを作成する

{
  "command": "create-table",
  "tableName": "users",
  "schema": "id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(255), email VARCHAR(255)"
}

2. データを挿入する

{
  "command": "insert-data",
  "tableName": "users",
  "data": {"username": "张三", "email": "zhangsan@example.com"}
}

プロジェクト構造

MySQLデータベースMCPサービス
├── src/
│   ├── services/
│   │   └── DatabaseService.js
│   ├── controllers/
│   │   └── DatabaseController.js
│   └── routes/
│       └── databaseRoutes.js
└── package.json

セキュリティ上の注意事項

• コードや環境変数に機密性の高いデータベース資格情報を保存しないでください。
• MySQLユーザーの権限を制限し、必要な操作のみを許可します。

📄 ライセンス

MIT