officelens

officelens

officelens は、Family Office Registry のホスト型 MCP サーバーに接続する小規模なローカルブリッジです。このレジストリは、スイスとリヒテンシュタインを中心とし、オーストリア、ドイツ、ドバイ、および米国の登録済みアドバイザーまでを対象とする、出典と日付が明記されたファミリーオフィスおよび関連企業のレジストリです。

このブリッジはレジストリのデータを保持せず、独自の検索も行いません。ライブエンドポイントから取得したままの上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果をそのまま返します。取得された機能はすべて読み取り専用です。この再構築では書き込み機能を追加していません。

ツール

• search_registry — 検証済みのファミリーオフィスおよび関連企業を検索します。すべての引数は任意です。q（公開フィールドである名称、都市、登録 ID、法的形態、注力分野タグを対象としたフリーテキスト検索。キーがある場合は、担当者と目的条項も検索対象になります）、country（CH、LI、AT、DE、AE、US のいずれか）、canton（ZH、ZG、GE などのスイスの州コード）、type（SFO、MFO、intermediary のいずれか）、alloc（企業の投資方法。サブスクリプション専用のフィルターで、キーがない場合は検索できません）、page（1 から指定。デフォルトは 1）、size（1 ページあたりの結果数。1〜25、デフォルトは 10。サブスクリプションキーがない場合は最大 25 件）、purpose（ユーザーが実行しようとしていることを 1 行で記述します。呼び出し元を記録せずにログに記録され、検索結果には影響しません）。公開レコードが 1 ページ分返されます。フィールドは公開サイトで掲載されているものと同じです。個人名、連絡手段、出典一覧、検証メモにはサブスクリプションが必要です。
• get_record — レジストリの id（search_registry が返す ID）で企業のレコードを 1 件取得します。purpose の 1 行の記述も指定できますが、任意です。サブスクリプションキーがない場合は公開フィールドと、完全なレコードに含まれる個人名付き役職の数が返されます。キーがある場合は、個人名付き役職、連絡手段、完全な出典一覧、検証メモが返されます。

設定

• FAMILYOFFICEREGISTRY_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://familyofficeregistry.com/api/mcp です。エイリアス FOR_MCP_URL も使用できます。（この上書き用フックは、この再構築独自のラベル付き再構成です。）
• FAMILYOFFICEREGISTRY_API_KEY（任意）— 設定すると、すべての上流リクエストに Authorization: Bearer <key> ヘッダーが付加されます。エイリアス FOR_API_KEY も使用できます。どちらも設定されていない場合、認証ヘッダーは送信されません。（この転送もラベル付き再構成です。元の機能はキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流サーバーとのストリーム可能な HTTP セッションを開始します。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo の name は officelens）、次に notifications/initialized 通知、続いて呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流サーバーが initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、その値はセッションの後続リクエストすべてに付与され、プロセスの存続中は同じセッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取られます。

上流サーバーからの成功結果は、上流サーバーが設定した isError フラグも含め、そのまま返されます。JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、完了できなかったリクエストなどの失敗は、テキストが officelens error: で始まる isError 結果として返されます（このエラー表示は、この再構築独自のラベル付き再構成です）。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドとしても実行できます（引数が不要なツールでは省略します）。

npx @reneturcios/officelens search_registry '{"country":"CH","canton":"ZH","type":"MFO"}'
npx @reneturcios/officelens get_record '{"id":"CHE-116.281.419"}'
npx @reneturcios/officelens --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/officelens mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "officelens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/officelens", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/officelens
docker run --rm ghcr.io/cloudcorprecords/officelens --version

コンテナーのデフォルトコマンドは mcp なので、最初の形式では stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC 上流サーバーを使用して実行されます。ライブネットワークへの呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。