mcp-server-demo

Business Request Server

ほかの PoC で使用するデモ用 PoC MCP サーバー

開発者

設定

サーバーまたはクライアントを実行する前に、サンプルから .env ファイルを作成します。

cp .env.example .env

.env を編集し、データベースの認証情報と Azure OpenAI の設定を入力します。

変数	説明	必須	デフォルト
BITS_DB_SERVER	SQL Server データベースのホスト名または IP アドレスです。	はい	missing.domain
BITS_DB_USERNAME	データベース認証に使用するユーザー名です。	はい	missing.username
BITS_DB_PWD	データベース認証に使用するパスワードです。	はい	missing.password
BITS_DB_DATABASE	接続する特定のデータベースの名前です。	はい	missing.dbname
HOST	MCP サーバーがバインドするホストアドレスです。	いいえ	0.0.0.0
PORT	MCP サーバーがリッスンするポートです。	いいえ	8000
MCP_SERVER_URL	MCP サーバーにアクセスできる URL です（クライアントで使用）。	いいえ	http://127.0.0.1:8000/mcp
CORS_ALLOW_ORIGINS	MCP サーバーへの接続を許可するオリジンをコンマ区切りで指定します。	いいえ	http://localhost,http://127.0.0.1
CORS_ALLOW_CREDENTIALS	CORS リクエストで認証情報（Cookie、認証ヘッダー）を許可するかどうかを指定します。	いいえ	false
AZURE_OPENAI_ENDPOINT	Azure OpenAI リソースのエンドポイント URI です（クライアントで使用）。	はい（クライアント）	-
AZURE_OPENAI_VERSION	Azure OpenAI の API バージョンです。	いいえ	2024-05-01-preview
CLIENT_ID	認証用の OAuth2 クライアント ID です（実験的機能）。	いいえ	-
CLIENT_SECRET	認証用の OAuth2 クライアントシークレットです（実験的機能）。	いいえ	-
REDIRECT_URI	認証用の OAuth2 リダイレクト URI です（実験的機能）。	いいえ	-

インストール

uv venv
uv pip install -e .
# then run it locally
mcp dev server.py
# or alternatively
python server.py

表示された URL にアクセスして、サーバーをテストします。

次に、Templates や search_business_requests などの関数をテストできます。

query に次の値を渡します。

{
  "query_filters": [
    {
      "name": "BR_SHORT_TITLE",
      "value": "Server",
      "operator": "="
    }
  ]
}

select_fields には次の値を渡します。

{
  "fields": [
    "BR_SHORT_TITLE"
  ]
}

その後、filter_results を使って結果をフィルタリングできます。

[
  {
    "column": "RPT_GC_ORG_NAME_EN",
    "operator": "contains",
    "value": "Correctional"
  }
]

Docker で実行する

docker build -t mcp-bits:local .
docker run -p 8080:8080 --env-file ./.env --name mcp-bits-container mcp-bits:local

pymssql の問題

Mac OSX での pymssql

pymssql は FreeTDS に依存しているため、事前に brew install freetds を実行してインストールしてください。

その後、コードの実行で問題が発生した場合は、次の手順を実行してください。

uv pip uninstall pymssql
uv pip install --pre --no-binary :all: pymssql --no-cache --no-build-isolation

また、uv の pyproject.toml に追加することもできます。

[tool.uv]
no-binary-package = ["pymssql"]

これで、すべて動作するはずです。

注：既知の問題として cython==3.1.0 に関するものがあります。こちら を参照してください。

現時点での回避方法は次のとおりです（この問題が修正されたら、これを削除してください）。

uv pip uninstall pymssql
export CFLAGS="-I$(brew --prefix freetds)/include"
export LDFLAGS="-L$(brew --prefix freetds)/lib"
uv pip install "packaging>=24" "setuptools>=54.0" "setuptools_scm[toml]>=8.0" "wheel>=0.36.2" "Cython==3.0.10" "tomli"
uv pip install --pre --no-binary :all: pymssql --no-cache --no-build-isolation

デプロイ

CI/CD

TODO

手動

CLI を使って Azure に手動でデプロイする方法は次のとおりです。

az webapp deployment source config-local-git \
  --name <WebAppName> \
  --resource-group <ResourceGroupName>
git remote add azure <GitURLFromPreviousStep>
git push azure main

ドキュメント

• デモの構築方法については、チュートリアルとしてこちらを使用してください。
• FastMCP のドキュメント
• MCP OAuth 2.0 認証