MSSQL

🚀 MSSQL MCP サーバー

このサーバーは、Microsoft SQL Server データベースへの接続に使用される Model Context Protocol (MCP) サーバーです。SQL クエリの実行やデータベース接続の管理ツールを提供します。

バージョン情報：このプロジェクトは Model Context Protocol SDK 1.9.0 を使用するようにアップグレードされました。詳細については、UPGRADE.md を参照してください。

🚀 クイックスタート

MSSQL MCP サーバーを使用することで、Microsoft SQL Server データベースへの接続や SQL クエリの実行が容易になります。以下のセクションでは、インストール方法や使用方法を説明します。

✨ 主な機能

• Microsoft SQL Server データベースへの接続をサポート
• SQL クエリの実行と管理
• 安全なデータベース操作のためのセキュリティ対策

📦 インストール

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

Smithery を通じて、Claude デスクトップ用に MSSQL MCP サーバーを自動インストールできます。

npx -y @smithery/cli install @c0h1b4/mssql-mcp-server --client claude

手動インストール

npm install mssql-mcp-server

💻 使用例

基本的な使用法

サーバーを MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "mssql": {
      "command": "mssql-mcp-server",
      "env": {
        "MSSQL_CONNECTION_STRING": "Server=localhost;Database=master;User Id=sa;Password=yourpassword;",
        // または個別の接続パラメータ:
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "yourpassword",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

高度な使用法

query ツールの使用

MSSQL データベースで SQL クエリを実行します。

パラメータ

• connectionString (文字列、オプション)：完全な接続文字列（個別パラメータと排他）
• host (文字列、オプション)：データベースサーバーのホスト名
• port (数字、オプション)：データベースサーバーのポート（デフォルト: 1433）
• database (文字列、オプション)：データベース名（デフォルト: master）
• username (文字列、オプション)：データベースのユーザー名
• password (文字列、オプション)：データベースのパスワード
• query (文字列、必須)：実行する SQL クエリ
• encrypt (ブール値、オプション)：暗号化を有効にする（デフォルト: false）
• trustServerCertificate (ブール値、オプション)：サーバー証明書を信頼する（デフォルト: true）

connectionString を提供するか、(host + username + password) を同時に提供する必要があります。

例

const result = await use_mcp_tool({
  server_name: 'mssql',
  tool_name: 'query',
  arguments: {
    host: 'localhost',
    username: 'sa',
    password: 'yourpassword',
    query: 'SELECT * FROM Users',
  },
});

🔧 サーバーの実行

ローカル開発

# 依存関係のインストール
npm install

# 開発モードで実行
npm run dev

# ビルド
npm run build

# ビルド後のサーバーを実行
npm start

Docker を使用する

# サービス（SQL Server + MCP サーバー）を構築して起動
docker-compose up

# または Docker イメージのみを構築
docker build -t mssql-mcp-server .

📚 テスト

# テストを実行
npm test

# カバレッジ付きのテスト
npm run test:coverage

🔧 セキュリティ

サーバーには、危険な SQL 操作を防止するためのセキュリティ対策が組み込まれています。

• DROP、TRUNCATE、ALTER、CREATE、EXEC などの潜在的に危険な操作の実行をブロックします。
• すべての入力パラメータとデータベース名の有効性を検証します。
• 合理的なクエリ長とタイムアウト制限を設定します。
• パフォーマンスとセキュリティを向上させるために接続プールを使用します。

📄 ライセンス

MIT