Fulcra MCP Server

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。请参阅 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：打开“我认识的 Agent”，可选择指定确切的对端用户 ID 或已发现的多方会话 ID。打开操作为只读；渲染需要支持 MCP Apps 的宿主。
• update_data_type：在用户授权并独立回读的情况下，更新自有的活动 v1 Event/Metric 类型的名称或描述。此操作不会更改架构、记录或共享内容；对于结果不确定的写入，需要进行核对。

仅供应用使用的实现工具不属于面向公众的模型参考文档。

调试 / 开发者工具

• 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"

Bug / 功能请求

欢迎通过本项目的 GitHub 仓库联系我们，或加入我们的 Discord直接联系。也可以发送电子邮件（[email protected]）。