MCPサーバー — 議事録管理

株式会社 | 内部用・機密

Azure Functions Python上に構築されたMCPサーバーです。議事録の取得、検証、ドラフト生成、編集、承認、Wordへの最終変換という完全なフローを管理するためのMCPツールを公開します。

利用可能なツール

ビジネスフロー

ActaWizard → ValidateActa → GenerateDraft → ドラフト表示 → UpdateDraft（0回以上） → ApproveDraft → GenerateDocx

Related MCP server: office-mcp-server

前提条件

• Python 3.10以上（推奨3.12）

• Azure Functions Core Tools v4

• Azurite（Storageエミュレーター — ローカルでも必須。MCP拡張機能がSSEトランスポートに使用します）

• azure-functions>=1.24.0（mcp_tool_triggerはこれより古いバージョンでは動作しません）

1. 依存関係をインストールする

python3 -m venv .venv
. .venv/bin/activate       # en Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt

2. テストを実行する（サーバーを起動する必要はありません）

tests/test_tools.py のテストは、Azure FunctionsランタイムやAzuriteを経由せずに各ツールのロジックを直接呼び出します。ビジネスロジックが機能することを確認する最も速い方法です：

pytest -v

5つのテストが成功するはずです。これには、セッション作成、DOCX生成までの完全なフロー、必須フィールド欠落時の検証、承認済みドラフトの編集不可の確認が含まれます。

3. 実際のMCPサーバーを起動する

# En otra terminal, arrancar el emulador de storage:
azurite --silent --location .azurite --debug .azurite/debug.log
# o, en VS Code: Ctrl+Shift+P -> "Azurite: Start"

func start

MCPサーバーは以下のWebhookを公開します：

http://localhost:7071/runtime/webhooks/mcp

4. ツールをエンドツーエンドでテストする

2つの方法があります：

a) MCP Inspector（推奨、実際のプロトコルで通信）：

npx @modelcontextprotocol/inspector

http://localhost:7071/runtime/webhooks/mcp/sse に接続し、ツール一覧を表示して、1つずつ呼び出し、JSON応答を確認します。

b) Postman： tests/Actas_MCP_Postman.json をインポートし、リクエストを順番（01から07）に実行します。最初の2つのリクエストは、session_id と draft_id を後続のリクエストのためにコレクション変数として自動保存します。

重要な注意事項

• local.settings.json は .gitignore に含まれています。リポジトリに資格情報をアップロードしないでください。

• 状態（セッション、ドラフト）はプロジェクトの .data/*.json に保存されます。これはローカル開発には十分ですが、本番環境には適していません：Azure Functionsではローカルファイルシステムは永続的ではなく、インスタンス間で共有されません。複数インスタンスでデプロイする前に、tools/storage.py をAzure Table Storage、Cosmos DB、またはBlob Storageに置き換えてください。

• host.json の system.webhookAuthorizationLevel は "Anonymous" に設定されており、ローカルテストを容易にしています。Azureにデプロイする前に、mcp_extension キーを要求するために "Function" または "System" に変更してください。

• UpdateDraft は、シンプルなルール（置換/削除/追加）でスペイン語の指示を解釈します。あいまいな指示は、厳密に適用される代わりに、ドラフトの末尾に追加されます。これは既知の制限であり、バグではありません。

クイックヒント

• ActaWizard は sessionId、status、nextField、question を返します。

• ValidateActa は complete と missingFields を返します。

• GenerateDraft は draftId と draftMarkdown を持つドラフトを作成します。

• UpdateDraft は承認済みのドラフトを編集できません。

• GenerateDocx はドラフトが承認されている場合のみ機能し、ファイルを fileBase64 として返します（.docx を取得するにはデコードしてください）。