Fulcra Context

官方

用于访问个人健康、锻炼、睡眠、位置等数据的Fulcra Context MCP服务器，所有数据均保持私密。基于Fulcra的Context构建。

GitHub
10

你可以用 Fulcra Context MCP 做什么？

  • 连接到 Fulcra Context — 将支持 OAuth2 的 MCP 客户端指向 https://mcp.fulcradynamics.com/mcp，即可连接到公共服务器实例。
  • 在本地通过 stdio 运行 — 设置 FULCRA_ENVIRONMENT 为 stdio，并使用 uvx 启动服务器，以建立本地 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。

使用代理进行远程连接

此服务器有一个运行中的公共实例，地址为 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）。