Natural Language MCP-MSSQL Client

自然言語 MCP-MSSQL クライアント

Model Context Protocol（MCP）を使用した、SQL データベース向けの自然言語インターフェースです。このクライアントでは、Claude AI を通じて、平易な英語の質問で Microsoft SQL Server データベースにクエリを実行できます。

機能

• 自然言語でのクエリ：平易な英語でデータベースについて質問できます
• MCP 連携：FastMCP を使用して MCP-MSSQL サーバーに接続します
• Claude AI：Anthropic の Claude API を使用して自然言語を SQL に変換します
• インタラクティブモード：質問を直接入力してデータベースの結果を取得できます
• デモモード：あらかじめ用意された質問を実行して、機能を紹介します

構成要素

1. MCP-MSSQL サーバー：MCP 経由で MS SQL Server データベースにアクセスできます
2. 自然言語クライアント：Claude API を使用して平易な英語を SQL に変換します
3. FastMCP フレームワーク：クライアントとサーバー間の通信を処理します

前提条件

• Python 3.8+
• システムに ODBC Driver for SQL Server がインストールされていること
• Anthropic API キー
• 必要な Python パッケージ（fastmcp、anthropic、python-dotenv など）

プロジェクト構成

MCP-MSSQL-SERVER-WEBAPP/
├── src/
│   └── mssql/           # MSSQL MCP server implementation
│       ├── __init__.py
│       └── server.py    # Main MCP server
├── interactive_client.py   # Interactive natural language client
├── demo_nl_client.py       # Demo client with predefined questions
├── .env                    # Environment configuration (not in git)
├── .env.example            # Example environment configuration
└── requirements.txt        # Project dependencies

セットアップ手順

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

   git clone https://github.com/david-ruffin/MCP-MSSQL-SERVER-WEBAPP.git
   cd MCP-MSSQL-SERVER-WEBAPP
   

2. 仮想環境をセットアップします：

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   

3. 環境を設定します： .env.example を .env にコピーし、データベースと API の認証情報を入力します：

   MSSQL_SERVER=your_server
   MSSQL_DATABASE=your_database
   MSSQL_USER=your_username
   MSSQL_PASSWORD=your_password
   MSSQL_DRIVER={ODBC Driver 17 for SQL Server}
   ANTHROPIC_API_KEY=your_api_key
   

クライアントの実行

インタラクティブモード

独自の質問をするには、インタラクティブクライアントを実行します：

source venv/bin/activate
export ANTHROPIC_API_KEY=$(grep ANTHROPIC_API_KEY .env | cut -d= -f2)
python interactive_client.py

プロンプトで自然言語の質問を入力すると、クライアントが SQL に変換して実行し、結果を表示します。

デモモード

あらかじめ用意された質問を確認するには、デモを実行します：

source venv/bin/activate
export ANTHROPIC_API_KEY=$(grep ANTHROPIC_API_KEY .env | cut -d= -f2)
python demo_nl_client.py

デモでは、自然言語から SQL への変換と結果を示すため、いくつかの質問が自動的に実行されます。

質問例

• 「製品はいくつありますか？」
• 「カリフォルニア州の顧客をすべて一覧表示してください」
• 「最も高価な製品を表示してください」
• 「製品カテゴリにはどのようなものがありますか？」
• 「2004 年に注文された注文はいくつありますか？」

ODBC Driver のセットアップ

このクライアントには、Microsoft ODBC Driver for SQL Server が必要です。インストール方法については、Microsoft の公式ガイドを参照してください：

• Windows
• macOS/Linux

ライセンス

MIT ライセンス