MCP Server Db Ts

Model Context Protocol (MCP)に基づくTypeScriptのデータベースクエリサーバーで、MySQLとPostgreSQLをサポートし、表構造クエリと読み取り専用のSQL実行機能を提供し、安全なクエリを保証します。

データベース開発者ツール #データベースクエリ #MCPプロトコル #読み取り専用操作 #トランザクションセキュリティローカル .TypeScript

スコア : 2ポイント

ダウンロード数 : 11

更新時間 : 2025-04-28

MCPデータベースサーバーとは？

MCPデータベースサーバーはミドルウェアサービスで、AIモデルが標準プロトコルを通じてリレーショナルデータベース(MySQL/PostgreSQL)を直接アクセスすることなく安全にクエリを実行できます。表構造情報と読み取り専用のクエリ機能を提供し、データアクセスの安全性を確保します。

MCPデータベースサーバーの使い方は？

使用手順は3つの簡単なステップに分かれます：1) データベース接続情報を設定する 2) 表構造をクエリする 3) 読み取り専用のSQLクエリを実行する。すべての操作はMCPプロトコルを通じて行われ、標準化と安全性が保証されます。

適用シナリオ

AIモデルが企業データベースにアクセスする必要があり、かつデータの安全性を確保する必要があるシナリオに最適です。例えば、データ分析アシスタントやスマートレポート生成などの読み取り専用のデータアクセスニーズに対応します。

主要機能

複数データベースサポートMySQLとPostgreSQLの2つの主流のリレーショナルデータベースを同時にサポートします。

表構造アクセスデータベースの表構造情報をリソースとして提供し、AIモデルがデータ構造を理解するのを支援します。

読み取り専用クエリトランザクションによりすべてのクエリが読み取り専用であることを保証し、データの安全性を保護します。

MCPプロトコル互換性Model Context Protocol標準に完全に準拠し、他のMCPコンポーネントとシームレスに統合できます。

利点と制限

利点

安全な隔離：AIモデルがデータベースに直接アクセスする必要がなく、セキュリティリスクを低減します。

標準化されたインターフェース：統一されたMCPプロトコルにより、統合プロセスが簡素化されます。

トランザクション保証：すべてのクエリは読み取り専用トランザクションで実行され、データの変更を防止します。

軽量で効率的：TypeScriptで実装され、実行効率が高いです。

制限

読み取り専用操作のみをサポートし、データの書き込みはサポートしていません。

現在はMySQLとPostgreSQLのみをサポートしています。

データベース接続情報を事前に設定する必要があります。

使い方

サービスをインストールする

リポジトリをクローンし、cnpmを使用して依存関係をインストールします。

データベースを設定する

.env.exampleファイルをコピーし、データベース接続情報を編集します。

サービスを起動する

MCPサーバーをビルドして起動します。

接続して使用する

MCPクライアントを通じて接続し、サービス機能を使用します。

使用例

製品表の構造を取得するAIアシスタントが正しいクエリを生成するために、製品表の構造を把握する必要があります。

販売データをクエリする先月の売上高レポートを生成するために、販売データをクエリする必要があります。

データベースを探索する初めて使用する際に、データベース内にどの表が利用可能かを把握します。

よくある質問

なぜ私のクエリが空の結果を返すのですか？

新しいデータベースのサポートを追加するにはどうすればいいですか？

サービスはどれくらいの同時クエリをサポートしますか？

クエリパフォーマンスを確保するにはどうすればいいですか？

🚀 MCP データベースサーバー（TypeScript）

これは、Model Context Protocol (MCP) に基づくデータベースクエリサーバーで、TypeScript で実装されています。このサーバーは、AI モデルが MySQL や PostgreSQL などのリレーショナルデータベースを安全にクエリできるようにします。

✨ 主な機能

MySQL と PostgreSQL データベースをサポート
表構造情報をリソースとして提供
読み取り専用の SQL クエリの実行をサポート
トランザクションを使用してクエリの安全性を確保

📦 インストール

cnpm を使用してインストールします。

git clone <repository-url>
cd mcp-server-db-ts
cnpm install

📚 ドキュメント

設定

.env.example ファイルを .env にコピーします。

cp .env.example .env

.env ファイルを編集して、データベース接続情報を設定します。

# データベース接続設定
# データベースタイプ: mysql または postgres
DB_TYPE=mysql

# MySQL 設定
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASS=your_password
MYSQL_DB=your_database

# PostgreSQL 設定
PG_HOST=127.0.0.1
PG_PORT=5432
PG_USER=postgres
PG_PASS=your_password
PG_DB=your_database

# サーバー設定
SERVER_NAME=mcp-server-db-ts
SERVER_VERSION=1.0.0

ビルド

cnpm run build

実行

cnpm start

開発モード

cnpm run dev

サポートされる MCP 機能

リソース

list_resources: データベース内のすべての表をリストする
read_resource: 指定された表の構造情報を取得する

ツール

db_query: 読み取り専用の SQL クエリを実行する

💻 使用例

基本的な使用法

すべての表をリストする
- MCP リクエスト: list_resources
- レスポンス: URI 形式ですべての表のリストを返す
表構造を取得する
- MCP リクエスト: 特定の表の URI を使用した read_resource
- レスポンス: 表の列情報を返す
クエリを実行する
- MCP リクエスト: call_tool を使用して db_query ツールと SQL クエリを指定
- レスポンス: クエリ結果を返す