Fulcra MCP Server

fulcra-context-mcp：Fulcra Context データにアクセスする MCP サーバー

これは、fulcra-api を使用して Fulcra API を呼び出すツールとリソースを提供する MCP サーバーです。

このサーバーのパブリックインスタンスは https://mcp.fulcradynamics.com/mcp で稼働しています。OpenAI プラグインは https://mcp.fulcradynamics.com/openai/mcp に接続し、get_location、get_sleep、get_workouts、get_time_series を除く同じツールを提供します。すぐに始めるには、https://docs.fulcradynamics.com/ をご覧ください。このリポジトリは主に、サーバーをローカルで実行する必要がある方、内部の仕組みを確認したい方、または貢献したい方向けです。

単独で実行した場合（または FULCRA_ENVIRONMENT が stdio に設定されている場合）、stdio トランスポートを使用するローカル MCP サーバーとして動作します。それ以外の場合は、Streamable HTTP トランスポートを使用するリモートサーバーとして動作します。OAuth2 コールバックを処理しますが、交換したトークンが MCP クライアントに漏れることはありません。代わりに、対応表を保持し、MCP クライアント間で独自の OAuth2 サービスを実行します。

OPENAI_APPS_CHALLENGE に OpenAI プラグインポータルのドメイン認証トークンを設定すると、/.well-known/openai-apps-challenge で提供されます。設定されていない場合、このパスは 404 を返します。

プロキシを使用したリモート接続

このサーバーのパブリックインスタンスは https://mcp.fulcradynamics.com/ で稼働しています。OAuth2 対応の MCP クライアントからこの URL に接続してください。

ローカル接続

uvx を使用した Claude Desktop の設定例：

{
    "mcpServers": {
        "fulcra_context": {
            "command": "uvx",
            "args": [
                "fulcra-context-mcp@latest"
            ]
        }
    }
}

モデル向けツール

MCP のディスカバリーにより、現在のツールスキーマと説明を取得できます。連絡先およびメタデータ用ツールは次のとおりです。

• open_agent_contacts：Agents I Know を開きます。必要に応じて、特定のピアユーザー ID または検出済みのマルチパーティスレッド ID を指定できます。開く操作は読み取り専用です。表示には MCP Apps に対応したホストが必要です。
• update_data_type：ユーザーの承認と個別の読み戻しを行い、所有しているアクティブな v1 Event/Metric タイプの名前または説明を更新します。スキーマ、レコード、共有設定は変更しません。不確実な書き込みは照合が必要です。

アプリ専用の実装ツールは、モデル向けの公開リファレンスには含まれていません。

デバッグ／開発者向けツール

• Agents I Know MCP App：このチェックアウトをプライベートな開発用トンネル経由で実行し、ChatGPT のサイドバー UI をテストします。HTML はこのサーバーに含まれており、別のプラグインサーバーは必要ありません。

• デバッグには、MCP Inspector と mcp-remote の両ツールが役立ちます。

ツールの表示

MCP クライアントはそれぞれ異なりますが、多くの場合、要約表示ではツールやパラメーターの説明が短縮されます。クライアントのモデルを混乱させないため、最初の説明は短くしてください（説明全体を1行にまとめ、80文字程度にします）。

ローカルで開発する際は、scripts/simulate_tools.py スクリプトを使って、MCP クライアントにどのように表示されるかをシミュレートできます。

FULCRA_ENVIRONMENT=stdio uv run python scripts/simulate_tools.py --command "uv run fulcra-context-mcp"

バグ／機能リクエスト

お気軽にこのプロジェクトの GitHub リポジトリからご連絡いただくか、Discord に参加して直接お問い合わせください。メール（[email protected]）でも受け付けています。