Fulcra Context

公式

Fulcra Context MCPサーバー。個人の健康、ワークアウト、睡眠、位置情報などにアクセスでき、すべてプライベートに保たれます。Context by Fulcraを基盤として構築されています。

GitHub
10

Fulcra Context MCPで何ができますか？

  • Fulcra Context に接続 — OAuth2 対応の MCP クライアントを https://mcp.fulcradynamics.com/mcp に接続して、公開サーバーインスタンスにアクセスします。
  • stdio でローカル実行 — uvx を起動し、FULCRA_ENVIRONMENT を stdio に設定して、ローカルの MCP 接続を確立します。
  • 知り合いのエージェントを開く — エージェントの連絡先を開くよう依頼します。必要に応じて、特定のピアユーザー ID または複数人スレッド ID を指定できます。
  • 招待を管理 — 招待を作成する、/mcp で招待を承諾する、または最初のメッセージに含まれるコードを使って、ユーザーが用意した招待と照合します。
  • データ型を更新 — 所有する有効な v1 Event 型または Metric 型の名前や説明を変更するよう依頼し、変更後に読み戻して確認します。

ホスト型 MCP サーバー

npx add-mcp 'https://mcp.fulcradynamics.com/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

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を除く同じツールを提供します。Claudeのコネクターとプラグインはhttps://mcp.fulcradynamics.com/claude/mcpに接続します。これは、これら4つを除いた/mcpツールを提供し、連絡先パネルは常に表示されます。すぐに始めるにはhttps://docs.fulcradynamics.com/をご覧ください。このリポジトリは主に、サーバーをローカルで実行する必要がある方、内部の仕組みを確認したい方、または貢献したい方を対象としています。

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

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

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

このサーバーの公開インスタンスがhttps://mcp.fulcradynamics.com/で稼働しています。OAuth2対応のMCPクライアントをそこに接続してください。

ローカル接続

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型の名前または 説明を更新し、独立して読み戻し確認を行います。スキーマ、レコード、共有は変更しません。 書き込み結果が不確かな場合は、照合が必要です。
  • accept_agent_invitation（/mcp上）: ユーザーの承認を得て、空の応答チャネルを作成または 再利用し、指定された招待者本人に限定して共有したうえで、指定された最初の紹介メッセージを 投稿します。結果が不確かな場合は読み取り専用で確認してください。保存済みの試行によって 再送信や再共有が自動的に行われることはありません。
  • match_agent_invitations（/mcp上）: メッセージ内の主張ではなく、最初のメッセージに含まれる コードと実際の受信共有の所有者を使って、ユーザーが準備した招待を完了します。
  • create_agent_invitation: 所有者が管理する1対1のチャネルと、永続化された安全な招待コードを作成します。 必要に応じて、指定された正確な受信者IDにその送信専用チャネルのみを共有します。 メッセージは送信されません。/mcpでは、結果に完全な invitation_textと、明示的な次の配信手順も含まれます。スキルは任意です。 別の呼び出しを行う前にエラーを照合してください。汎用作成へのフォールバックはしないでください。 招待ワークフローとホスト機能の境界をご覧ください。 /openai/mcpは既存のプラグイン契約と招待UIを維持します。

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

デバッグ / 開発者ツール

  • 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に参加して直接お問い合わせください。メールでも受け付けています（support@fulcradynamics.com）。