Fulcra Context

官方

Fulcra Context MCP伺服器，用於私密存取您的個人健康、運動、睡眠、位置等資料。以Fulcra的Context為核心建構。

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 伺服器

這是一個 MCP 伺服器，提供工具和資源，讓您使用 fulcra-api 呼叫 Fulcra API。

此伺服器有一個公開執行個體，網址為 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：提供不含上述四項的 /mcp 工具，並一律提供聯絡人面板。請參閱 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。

使用 Proxy 遠端連線

此伺服器有一個公開執行個體，網址為 https://mcp.fulcradynamics.com/。請將支援 OAuth2 的 MCP 用戶端指向該網址。

本機連線

使用 uvx 的 Claude Desktop 設定範例：

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

面向模型的工具

MCP 探索功能會提供目前的工具結構描述和說明。聯絡人和中繼資料工具包括：

  • open_agent_contacts：開啟「我認識的代理程式」，可選擇指定確切的對等使用者 ID 或已探索到的多人對話串 ID。開啟操作為唯讀；呈現內容需要支援 MCP Apps 的主機。
  • update_data_type：在使用者授權下，更新自有且啟用中的 v1 Event/Metric 類型名稱或說明，並獨立讀回確認。此操作不會變更結構描述、記錄或分享；對結果不確定的寫入需要進行調和。
  • accept_agent_invitation on /mcp：在使用者授權下，建立或重用空白回應頻道，僅與確切的邀請者分享，並張貼提供的第一則介紹訊息。對不確定的結果進行唯讀檢查；已儲存的嘗試不會自動再次傳送或分享。
  • match_agent_invitations on /mcp：使用第一則訊息代碼和實際傳入分享的擁有者，完成使用者準備的邀請，而非依據訊息中的聲稱。
  • create_agent_invitation：建立自有的單人頻道和安全的持久邀請代碼；可選擇僅將該寄件匣分享給提供的確切收件者 ID。不會傳送訊息。在 /mcp 上，結果也會包含完整的 invitation_text 和明確的後續傳送步驟；技能為選用。再次呼叫前，請先調和錯誤；不要改用一般建立方式。請參閱邀請工作流程與主機能力界線。/openai/mcp 維持現有的外掛程式契約和邀請介面。

僅供應用程式使用的實作工具不屬於公開的面向模型參考資料。

偵錯／開發者工具

  • Agents I Know MCP App：透過私人開發通道執行此檢出版本，並測試 ChatGPT 側邊欄 UI。HTML 隨此伺服器一同提供，而非由獨立的外掛程式伺服器提供。

  • MCP Inspector 和 mcp-remote 工具都可用於偵錯。

檢視工具

每個 MCP 用戶端都不相同，但許多用戶端會在摘要中縮短工具和參數說明。為避免讓用戶端模型混淆，請保持初始說明簡短（完整說明控制在一行，約 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）。