Vascue Public Knowledge Search

Vascue Public Knowledge Search（MCP サーバー）

Vascue の公開ドキュメントを検索する Model Context Protocol サーバーです。医療業務、クリニック向け Vascue Front Desk、医療提供者側の保険請求自動化、診療所管理システムとの連携（Cliniko および Nookal との双方向同期に対応。Jane、Mindbody、PracticeHub、HexaHealth、Halaxy、Clinicea、ClinicOffice、Semble、Plato Medical、JERA との連携は開発中）、セキュリティ、導入事例、料金を検索できます。

次の 2 つの同等な形式で利用できます。

• ホスト型（常に最新）： https://www.vascue.io/mcp/search - ストリーミング可能な HTTP、認証不要です。

• 自己完結型（このリポジトリ）： python server.py - 公開ページの同梱スナップショット（content/、リリースごとに scripts/fetch_content.py で更新）を対象とするローカル BM25 検索です。実行時にネットワーク接続を必要としないため、オフラインでも動作し、ディレクトリからビルドされるリリースで使用されます。

• エンドポイント： https://www.vascue.io/mcp/search（ストリーミング可能な HTTP、認証不要）

• サーバーカード： https://www.vascue.io/.well-known/mcp/server-card.json

• レジストリ名： io.vascue/public-knowledge-search

• 運営元： Vascue Limited（ISO 27001 認証取得済み）

公開コンテンツのみが対象です。 このサーバーは、公開されている製品ページと教育関連ページをインデックス化します。患者情報、請求書類、クリニックの認証情報、予約依頼は決して送信しないでください。エージェントによるクリニック予約は別個の研究パイロットであり、公開 API ではありません。

接続

ストリーミング可能な HTTP に対応した MCP クライアントであれば、エンドポイントに直接接続できます。

Claude Code

claude mcp add --transport http vascue-search https://www.vascue.io/mcp/search

Cursor / Claude Desktop / その他の stdio のみ対応したクライアント（mcp-remote 経由）

{
  "mcpServers": {
    "vascue-search": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.vascue.io/mcp/search"]
    }
  }
}

自己完結型のローカルサーバー（stdio；スナップショット同梱、ネットワーク不要）

pip install -r requirements.txt
python server.py

Docker（自己完結型サーバーをビルド）

docker build -t vascue-public-knowledge-search .
docker run -i --rm vascue-public-knowledge-search

ツール

どちらの形式にも、認証不要で読み取り専用の search ツールが 1 つあります。ホスト型エンドポイントとローカルサーバーでは、入力が異なります。

ホスト型エンドポイント（https://www.vascue.io/mcp/search）

Vascue の公開ページを対象としたハイブリッド検索（キーワード＋ベクトル）です。一致した抜粋を、回答で出典として引用できる正規の https://www.vascue.io/... URL とともに返します。

入力	型	備考
query	string（必須）	自然言語の質問またはキーワード。例：「Vascue は保険請求の事前承認をどのように処理するか」。
ai_search_options.retrieval.retrieval_type	"hybrid" | "vector" | "keyword"	デフォルトは hybrid です。
ai_search_options.retrieval.max_num_results	integer 1–50	デフォルトは 8 です。
ai_search_options.retrieval.match_threshold	number 0–1	デフォルトは 0.35 です。
ai_search_options.retrieval.context_expansion	integer 0–3	含める隣接チャンク数です。

クエリの書き換えと再ランキングはサーバー側で無効になっています。サーバーはソースチャンクのみを返し、生成された回答は返さないため、出典なしで Vascue の見解として提示されることはありません。レート制限：クライアントごとに毎分 60 リクエストです。

呼び出し例：

{ "name": "search", "arguments": { "query": "Cliniko integration for Vascue Front Desk" } }

このエンドポイントは、vascue.io の承認済み公開 Markdown エクスポートを対象とする Cloudflare AI Search インスタンスを基盤としています（https://www.vascue.io/.well-known/ai-search.json のサービス記述子に、インデックス対象と対象外が記載されています）。

ローカルサーバー（server.py）

同梱された content/ スナップショットを対象とする BM25 キーワード検索です。実行時にネットワーク呼び出しは行いません。{"chunks": [...]} を返します。各チャンクには url、title、score（最適一致に対する相対値、0～1）、text が含まれます。

入力	型	備考
query	string（必須）	自然言語の質問またはキーワード。3～15 語とし、1 回の呼び出しにつきトピックは 1 つにしてください。
max_num_results	integer 1–50	デフォルトは 8 です。

呼び出し例：

{ "name": "search", "arguments": { "query": "Cliniko integration", "max_num_results": 5 } }

開発

docker build -t vascue-public-knowledge-search .
node scripts/smoke.mjs docker run -i --rm vascue-public-knowledge-search   # initialize -> tools/list
node scripts/smoke.mjs npx -y mcp-remote https://www.vascue.io/mcp/search --transport http-only

CI では、プッシュのたび、および毎週、同じビルドとスモークテストが実行されるため、上記のバッジはエンドポイントの稼働状況の指標にもなります。

ディレクトリのビルド仕様

ソースからサーバーをビルドするディレクトリ（例：Glama）では、自己完結型の形式を使用します。生成されるビルドイメージはさまざまで（pip のない uv 管理の Python や、PEP 668 による外部管理のシステム Python など）、明示的に venv を使用してください。

• ビルド手順：["uv venv /opt/venv && uv pip install --python /opt/venv/bin/python -r requirements.txt"]
• CMD：["/opt/venv/bin/python", "server.py"]
• 環境変数はありません。

通常の pip が利用できる場合は、pip install -r requirements.txt + ["python", "server.py"] でも動作します。

pip install -r requirements.txt
SMOKE_CALL_QUERY="Cliniko integration" node scripts/smoke.mjs python server.py   # local server
node scripts/smoke.mjs python bridge.py                                          # stdio bridge to the hosted endpoint
python scripts/fetch_content.py                                                  # refresh the content/ snapshot

その他の機械可読な公開情報

• https://www.vascue.io/llms.txt
• https://www.vascue.io/openapi.json（公開読み取り専用コンテンツ API）
• https://www.vascue.io/.well-known/agent-skills/index.json（エージェントスキル。vascue-io/skills にもあります）

ライセンス

このリポジトリ（README、マニフェスト、Dockerfile）は MIT ライセンスです。エンドポイントが提供するコンテンツは、Vascue の公開ウェブサイトのコンテンツです。