SQL MCP サーバー

SQL MCP サーバー (TypeScript)

このプロジェクトは、言語モデルやその他の MCP 互換クライアントが必要に応じて SSH 要塞トンネル経由で PostgreSQL データベースをクエリできるようにする Model Context Protocol (MCP) サーバーのTypeScript 実装を提供します。

柔軟性と安全なデータベースアクセスを実現するように構築されており、読み取り専用トランザクションで AWS RDS をサポートし、stdin/stdout ベースの通信を使用するため、ローカル、コンテナ化、または AI 駆動型のユースケースに適しています。

特徴

🔒 SSH トンネル経由でプライベート RDS インスタンスに安全にアクセスするための SSH 要塞サポート
🐘 pgライブラリを使用した PostgreSQL 読み取り専用クエリエンジン
📡 STDIOベースのMCPプロトコルトランスポート
🧠メモリバンクMCPサーバーと互換性があります
⚙️ .envまたは環境変数で簡単に設定可能
🧪 Jestとモックで完全にテスト可能

インストール

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

git clone https://github.com/your-org/sql-mcp-server.git
cd sql-mcp-server
npm install
npm run build

Configuration (Optional .env file)

Create a .env file in the project root:

DB_USER=postgres
DB_PASS=yourpassword
DB_HOST=localhost
DB_PORT=5432
DB_NAME=mydatabase
USE_SSH_TUNNEL=true
SSH_BASTION_HOST=bastion.example.com
SSH_BASTION_USER=ec2-user
SSH_PRIVATE_KEY_PATH=~/.ssh/id_rsa

Usage

Run the server using npx:

npx -y @modelcontextprotocol/server-postgres postgresql://<user>:<pass>@localhost:5433/<dbname>

For direct connection without SSH tunneling, set the appropriate environment variables:

DB_HOST=rds-host.amazonaws.com DB_PORT=5432 npx -y @modelcontextprotocol/server-postgres postgresql://<user>:<pass>@rds-host.amazonaws.com/<dbname>

Sample Input

{
  "type": "call_tool",
  "params": {
    "name": "query",
    "arguments": {
      "sql": "SELECT * FROM users LIMIT 10"
    }
  }
}

Sample Output

{
  "content": [
    {
      "type": "text",
      "text": "[{\"id\":1,\"name\":\"Alice\"}]"
    }
  ],
  "isError": false
}



⸻

Related Docs
	•	Architecture
	•	Domain Models
	•	Glossary
	•	Coding Standards
	•	Tech Stack
	•	User Guide

⸻

License

MIT

⸻

Contribution Guide

We welcome community contributions! Please see CONTRIBUTING.md for details.

⸻

Compatibility

This implementation follows the Model Context Protocol (MCP) and has been tested for compatibility with:
	•	memory-bank-mcp-server
	•	Claude Desktop (via STDIO)
	•	Cursor IDE
	•	Supabase + MCP integration

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

言語モデルが SSH 要塞トンネルの背後にあるものも含め、PostgreSQL データベースを安全にクエリできるようにするモデルコンテキストプロトコルサーバーの TypeScript 実装。

Related MCP Servers

PostgreSQL MCP Server
vignesh-codes
-
security
A
license
-
quality
A Model Context Protocol server providing LLMs read-only access to PostgreSQL databases for inspecting schemas and executing queries.
Last updated -
16,948
17
JavaScript
MIT License
PostgreSQL MCP Server
HenkDz
-
security
A
license
-
quality
A Model Context Protocol server that enables powerful PostgreSQL database management capabilities including analysis, schema management, data migration, and monitoring through natural language interactions.
Last updated -
355
46
TypeScript
AGPL 3.0
MCP Database Server
dwarvesf
-
security
F
license
-
quality
A Model Context Protocol server that provides tools for interacting with databases, including PostgreSQL, DuckDB, and Google Cloud Storage Parquet files.
Last updated -
2
TypeScript
PostgreSQL Query MCP Server
RathodDarshil
-
security
F
license
-
quality
A secure Model Context Protocol server that allows Claude to execute read-only SQL queries against a PostgreSQL database, enabling natural language interaction with database data.
Last updated -
TypeScript

View all related MCP servers

SQL MCP Server