Mysql Read Only

🚀 MCP サーバー：MySQL 実装ガイド

このガイドでは、MCP サーバーの MySQL 実装について、インストール方法からテスト、トラブルシューティング、コントリビュートまでの手順を説明します。

🚀 クイックスタート

このガイドを通じて、MCP サーバーの MySQL 実装を行い、テストを実行し、トラブルシューティングやコントリビュートの方法を学ぶことができます。

📦 インストール

Smithery を使用したインストール

smithery install @benborla/mcp-server-mysql

MCP Get を使用したインストール

mcp-get install @benborla/mcp-server-mysql

📚 ドキュメント

設定説明

ドキュメントに記載されている設定オプションに基づき、以下の方法で環境変数を設定することができます。

PATH 環境変数の設定（オプション）

export PATH="/path/to/node/bin:$PATH"

設定例

{
  "env": {
    "NODE_OPTIONS": "--loader ts-node/index",
    "PATH": "/path/to/node/bin:/usr/bin:/bin"
  }
}

テストガイド

データベースの準備

1. テストユーザーとデータベースの作成

   CREATE USER 'mcp_test'@'localhost' IDENTIFIED BY 'mcp_test_password';
   GRANT ALL PRIVILEGES ON mcp_test.* TO 'mcp_test'@'localhost';
   FLUSH PRIVILEGES;
   

2. データベーススクリプトの実行

   pnpm run setup:test:db
   

3. テスト環境ファイルの作成 プロジェクトのルートディレクトリに .env.test ファイルを作成します。

   MYSQL_HOST=127.0.0.1
   MYSQL_PORT=3306
   MYSQL_USER=mcp_test
   MYSQL_PASS=mcp_test_password
   MYSQL_DB=mcp_test
   

package.json の更新

package.json に以下のスクリプトを追加します。

{
  "scripts": {
    "setup:test:db": "ts-node scripts/setup-test-db.ts",
    "pretest": "pnpm run setup:test:db",
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage"
  }
}

テストの実行

# テスト環境の初期化
pnpm run setup:test:db

# すべてのテストを実行
pnpm test

トラブルシューティング

Smithery を使用した診断

smithery status @benborla/mcp-server-mysql

smithery diagnose @benborla/mcp-server-mysql

smithery logs @benborla/mcp-server-mysql

一般的な問題

1. 接続問題

   • MySQL サーバーの実行状態を確認します。
   • ユーザーの権限設定を確認します。

2. パフォーマンス問題

   • データベースの設定パラメータを調整します。
   • より効率的なデータクエリ方法を使用します。

3. バージョン互換性

   • Node.js と関連ツールのバージョンがプロジェクトの要件と一致していることを確認します。

コントリビュートガイド

コードリポジトリのアクセス

git clone https://github.com/yourusername/mcp-server-mysql.git

開発環境の設定

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-server-mysql.git
   cd mcp-server-mysql
   

2. 依存関係をインストールします。

   pnpm install
   

3. 開発サーバーを起動します。

   pnpm dev
   

ドキュメント参照

• 公式ドキュメント：MCP サーバードキュメント
• コミュニティサポート：GitHub リポジトリ

以上の手順に従えば、MCP サーバーのインストール、設定、テストを簡単に行うことができます。問題が発生した場合は、公式ドキュメントを参照するか、コミュニティに相談してください。