mssql-mcp

AWS Secrets Managerからツール呼び出し時に接続情報を取得する、読み取り専用のMicrosoft SQL Server MCPサーバーです。シークレットの参照先以外、ディスクや環境変数から読み取られるものはありません。

クロスプラットフォーム対応：純粋なJavaScriptで記述されたMCPサーバー（ネイティブ依存やODBC依存なし）であるため、npxを介してmacOS、Linux、Windows上で同一に動作します。

.claude.jsonでの設定

{
  "mcpServers": {
    "my-db": {
      "command": "npx",
      "args": ["-y", "@dhipskind253/mssql-mcp"],
      "env": {
        "AWS_ACCOUNT_ID": "123456789012",
        "SECRET_NAME": "my-aws-secret",
        "AWS_REGION": "us-east-1",
        "TRUST_SERVER_CERTIFICATE": "false"
      }
    }
  }
}

標準のAWS SDK環境変数（AWS_PROFILE、AWS_ACCESS_KEY_IDなど）は、デフォルトの認証情報プロバイダーチェーンを介して尊重されます。ほとんどのユーザーはaws sso loginを実行して最新の状態にするだけで十分です。

Related MCP server: MSSQL MCP Python Server

必要なシークレットJSON

シークレットの値は、少なくとも以下のフィールドを含むJSONドキュメントである必要があります：

{
  "host": "myserver.database.windows.net",
  "port": 1433,
  "database": "mydb",
  "username": "ro_user",
  "password": "..."
}

databaseは**dbname**として提供することも可能です。これはAWSが組み込みのRDS認証情報シークレットテンプレートで使用するフィールド名です。両方が存在する場合はdatabaseが優先されます。

オプションのフィールド（デフォルト値）：

TLS証明書の信頼設定はシークレットからは読み取られません。代わりにMCPサーバーのenvブロックでTRUST_SERVER_CERTIFICATEを設定してください。シークレットJSON内のtrustServerCertificateフィールドは無視されます。

設計上の読み取り専用制限

このサーバーはデータの挿入、更新、削除を行うことはできません。以下の2つのレイヤーで強制されます：

1. run_selectツールは、単一のSELECTまたはWITH（CTE）ステートメント以外のすべて（INSERT、UPDATE、DELETE、EXEC、MERGE、DROP、ALTER、SELECT INTOなど）を字句解析レベルで拒否します。

2. 他のツールは書き込みSQLを発行しません。get_procedure_definitionはプロシージャのソースを返しますが、プロシージャを実行することはありません。

注意: 字句解析によるチェックはUXのためのものであり、セキュリティ境界ではないことに留意してください。将来の安全のため、Secrets Managerに設定する認証情報は読み取り専用のデータベースログイン（SELECTとVIEW DEFINITIONのみ許可されたもの）にすることを推奨します。そうすれば、誤った書き込み（または将来のバグ）はSQL Server自体によって拒否されます。

再起動なしでのAWS認証情報の更新

サーバーはデフォルトのAWS認証情報チェーンを使用するため、SSOセッションの期限が切れてもClaudeやMCPサーバーを再起動せずに復旧できます：

1. 任意のターミナルでaws sso loginを実行します。

2. Claudeに**refresh_secret**ツールを呼び出すよう依頼します。

3. 作業を続行します。

AWS認証が原因でツール呼び出しが失敗した場合、エラーメッセージにその旨が明示され、同じ手順を促されます。エラーには安定したプレフィックスが付けられます：

ツール

ローカル開発

npm install
npm run build
# point your .claude.json command at the local build:
#   "command": "node",
#   "args": ["/absolute/path/to/mssql-mcp/dist/index.js"]