Fulcra Context

oficial

Servidor MCP Fulcra Context para acessar seus dados pessoais de saúde, treinos, sono, localização e muito mais, tudo de forma privada. Construído em torno do Context by Fulcra.

O que você pode fazer com Fulcra Context MCP?

  • Conectar aos dados do Fulcra Context — Peça ao seu assistente de IA para acessar seus dados do Fulcra Context por meio da integração fulcra-api.
  • Executar localmente ou remotamente — Configure o servidor para rodar via stdio localmente ou conecte-se à instância pública em https://mcp.fulcradynamics.com/mcp.
  • Usar autenticação OAuth2 — Deixe o servidor lidar com callbacks OAuth2 e gerenciamento de tokens sem expor tokens aos clientes MCP.
  • Iniciar via uvx — Configure o servidor no Claude Desktop ou clientes semelhantes usando o comando uvx com fulcra-context-mcp@latest.

Documentação

fulcra-context-mcp: Um servidor MCP para acessar seus dados do Fulcra Context

Este é um servidor MCP que fornece ferramentas e recursos para chamar a API Fulcra usando fulcra-api.

Existe uma instância pública deste servidor rodando em https://mcp.fulcradynamics.com/mcp. Consulte https://docs.fulcradynamics.com/ para começar rapidamente. Este repositório é principalmente para usuários que precisam executar o servidor localmente, querem ver como funciona por dentro ou desejam contribuir.

Quando executado por conta própria (ou quando FULCRA_ENVIRONMENT está definido como stdio), ele atua como um servidor MCP local usando o transporte stdio. Caso contrário, atua como um servidor remoto usando o transporte HTTP Streamable. Ele lida com o callback OAuth2, mas não vaza os tokens trocados para os clientes MCP. Em vez disso, mantém uma tabela de mapeamento e executa seu próprio serviço OAuth2 entre os clientes MCP.

Conexão Remota usando Proxy

Existe uma instância pública deste servidor rodando em https://mcp.fulcradynamics.com/. Aponte seus clientes MCP compatíveis com OAuth2 para esse endereço.

Conexão Local

Exemplo de configuração do Claude Desktop usando uvx:

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

Depuração / Ferramentas de Desenvolvimento

Visualizando Ferramentas

Cada cliente MCP é diferente, mas muitos abreviaram descrições de ferramentas e parâmetros para resumos. Para evitar confundir os modelos do cliente, mantenha as descrições iniciais curtas (descrição completa em uma linha, cerca de 80 caracteres).

Ao desenvolver localmente, o script scripts/simulate_tools.py simula como isso pode parecer para um cliente MCP:

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

Bugs / Solicitações de Recursos

Sinta-se à vontade para entrar em contato via o repositório GitHub deste projeto ou entre no nosso Discord para falar diretamente. E-mail também funciona (support@fulcradynamics.com).