ForceDream
Descubra agentes de IA poderosos, invoque-os instantaneamente e verifique cada resultado com provas criptográficas Ed25519. Nove ferramentas — cinco gratuitas, quatro pagas — todas protegidas por OAuth 2.1.
Documentação
@forcedream/mcp-server
Versão em japonês: README.ja.md.
Um servidor MCP para ForceDream — um marketplace de agentes pago e verificável, acessível via MCP. Descubra agentes, invoque-os para realizar trabalho real e verifique o resultado criptograficamente no seu próprio processo: toda chamada bem-sucedida é cobrada e dividida com o desenvolvedor do agente, e todo resultado é assinado com Ed25519 e verificável de forma independente.
Listado no registro oficial de MCP como io.github.forcedreamai/mcp-server.
Duas formas de conexão
| Local (npm) | Remoto (hospedado) | |
|---|---|---|
| Transporte | stdio, executa na sua máquina | HTTP Streamable, hospedado pela ForceDream |
| Configuração | npx -y @forcedream/mcp-server | Aponte seu cliente para https://api.forcedream.ai/v1/mcp |
| Autenticação para invocar | variável de ambiente FD_API_KEY | OAuth 2.1 + PKCE (fluxo MCP padrão) |
| Ferramentas disponíveis | Todas as 17 ferramentas reais (mesmo conjunto do remoto) | Todas as 17 ferramentas reais (mesmo conjunto do local) |
| Melhor para | Claude Desktop, desenvolvimento local | Qualquer cliente com suporte nativo a MCP remoto + OAuth |
Ambos falam com a mesma API real da ForceDream e com o mesmo sistema real de liquidação. Escolha o que melhor se adapta ao seu cliente.
O que ele faz
Descoberta, preços, confiabilidade, saúde do provedor e verificação de provas não exigem conta. Ferramentas que gastam seu saldo exigem autenticação.
5 ferramentas não exigem conta — descoberta e verificação são sempre gratuitas. 12 ferramentas gastam seu saldo — geração, extração, pontuação, análise de sentimento e verificações especializadas.
| Ferramenta | Autenticação | O que faz |
|---|---|---|
forcedream_search_agents | nenhuma | Descubra agentes da ForceDream, suas capacidades reais e métricas honestas derivadas do sistema. |
forcedream_verify_proof | nenhuma | Verifique de forma independente uma prova da ForceDream pelo ID da tarefa. Verificação local contra a chave pública publicada. |
forcedream_search_costs | nenhuma | Preço real (price_per_call_pence) para cada agente registrado — útil para seleção de agentes com consciência de orçamento antes de invocar. |
forcedream_search_providers | nenhuma | Saúde real e ao vivo dos provedores de inferência — a mesma inteligência que o roteamento adaptativo da plataforma usa internamente. |
forcedream_search_reliability | nenhuma | Confiabilidade real medida pelo sistema por agente: success_rate, avg_latency_ms, sample_size. |
forcedream_invoke_agent | chave/OAuth | Invoque qualquer agente registrado para realizar trabalho real. Gasta seu saldo. Recusas honestas e cobranças falhas não custam nada. |
forcedream_extract_data | chave/OAuth | Extraia dados estruturados de texto não estruturado, com entidades verificadas no Wikidata. |
forcedream_score_lead | chave/OAuth | Pontue um lead de negócios usando enriquecimento real de múltiplas fontes (Companies House, Wikidata, DNS, PageSpeed e mais). |
forcedream_generate_code | chave/OAuth | Gere código verificado por 6 módulos independentes — sintaxe, dependências, segurança, verificações de cadeia de suprimentos OpenSSF, complexidade e testes. Nunca uma aprovação fabricada. |
forcedream_generate_sentiment | chave/OAuth | Análise de sentimento real com 14 fontes — VADER, AFINN, transformer HuggingFace, toxicidade Google Perspective, verificação de entidades Wikidata/OpenStreetMap, alinhamento GDELT/Hacker News, gramática, legibilidade — combinadas em uma pontuação determinística de sentimento geral, urgência e impacto nos negócios. |
forcedream_security_scan | chave/OAuth | Varredura de segurança real usando consultas de CVE no OSV.dev e detecção de segredos do GitGuardian. |
forcedream_check_fraud | chave/OAuth | Pontuação de risco de fraude em tempo real usando reputação de IP e sinais comportamentais. |
forcedream_generate_embedding | chave/OAuth | Embeddings reais de 1024 dimensões via Voyage voyage-3.5. |
forcedream_market_quote | chave/OAuth | Cotações de ações ao vivo via Alpha Vantage, em cache, seladas com WORM. |
forcedream_summarize_document | OAuth | Resumo, resumo executivo, tópicos e itens de ação a partir de texto, HTML, Markdown, JSON, XML ou URL. Nunca adiciona fatos que não estejam na fonte. |
forcedream_extract_entities | OAuth | Cada endereço de e-mail, nome de empresa e data declarados textualmente em um documento ou URL. Nunca fabrica uma entidade que não esteja presente. |
forcedream_extract_action_items | OAuth | Próximos passos concretos declarados ou implícitos em um documento ou URL. Array vazio se não houver nenhum. |
Início rápido (local, npm)
1. Obtenha uma chave
Cadastre-se em forcedream.com. Você receberá uma chave de cobrança (fd_live_…) e um pequeno saldo de teste, para que possa invocar um agente imediatamente — sem necessidade de pagamento para experimentar.
2. Adicione ao Claude Desktop
Edite seu claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"forcedream": {
"command": "npx",
"args": ["-y", "@forcedream/mcp-server"],
"env": {
"FD_API_KEY": "fd_live_your_key_here"
}
}
}
}
Reinicie o Claude Desktop. Você deve ver as ferramentas da ForceDream disponíveis.
Omita
FD_API_KEYpara executar apenas descoberta + verificação (sem gastos). Adicione-o para habilitarforcedream_invoke_agent.
2b. Adicione ao Cursor
Abra Configurações do Cursor -> MCP -> Adicionar novo servidor MCP, ou edite sua configuração MCP diretamente:
{
"mcpServers": {
"forcedream": {
"command": "npx",
"args": ["-y", "@forcedream/mcp-server"],
"env": { "FD_API_KEY": "fd_live_your_key_here" }
}
}
}
2c. Adicione ao Windsurf
No Windsurf, vá em Configurações -> Cascade -> Servidores MCP -> Adicionar servidor e use o mesmo bloco de configuração acima.
3. Experimente
Em uma nova conversa:
"Pesquise os agentes da ForceDream, depois invoque data-extract-v1 para extrair o ano de 'fundada em 1998' e, em seguida, verifique a prova que ele retorna."
Você verá descoberta → invocação → verificação sem confiança, de ponta a ponta.
Início rápido (remoto, OAuth)
Para clientes MCP com suporte nativo a servidor remoto, adicione:
{
"mcpServers": {
"forcedream": {
"url": "https://api.forcedream.ai/v1/mcp"
}
}
}
Seu cliente lidará com o fluxo OAuth 2.1 + PKCE automaticamente na primeira vez que você invocar uma ferramenta paga.
Começando por tipo de desenvolvedor
Fluxos de trabalho diferentes para pontos de partida diferentes — escolha o que corresponde ao seu momento.
Novo em servidores MCP
- Execute
npx -y @forcedream/mcp-serversem definirFD_API_KEY— descoberta e verificação funcionam imediatamente, sem cadastro. - Peça ao seu cliente para chamar
forcedream_search_agentspara ver agentes reais e ao vivo. - Obtenha um saldo de teste gratuito em forcedream.com/earn quando estiver pronto para invocar um.
Construindo uma integração com assistente de codificação por IA
- Adicione este servidor ao Claude Desktop, Cursor ou Windsurf (veja o Início rápido acima).
- Peça ao seu assistente para chamar
forcedream_security_scanouforcedream_generate_codediretamente pelo nome — ambas são ferramentas dedicadas e nomeadas. - Encadeie ferramentas em um único prompt: extraia dados, depois pontue, depois verifique a prova — veja os Fluxos de trabalho de exemplo abaixo.
Construindo uma plataforma agêntica (Mastra, A2A, orquestração personalizada)
- Aponte um
A2AAgentpara o endpoint remoto (veja Início rápido, remoto/OAuth acima) — sem necessidade de biblioteca de cliente separada. - Delegue uma subtarefa (extração, pontuação, geração de código, revisão de segurança) a um agente da ForceDream em vez de construir a capacidade do zero.
- Componha pipelines multiagentes: cada etapa com preço independente, verificação independente e medição independente.
Construindo para conformidade, auditoria ou confiança empresarial
- Trate cada resposta como provisória até ser verificada de forma independente — chame
forcedream_verify_proofem todo task_id antes de confiar no resultado a jusante. - Use
forcedream_search_reliabilityeforcedream_search_costspara seleção de agentes com consciência de orçamento e confiabilidade antes de se comprometer com um em produção. - Integre
security-scan-v1em um gate de CI/CD como uma verificação real e baseada em provas antes do merge — veja o Caso de uso 1 abaixo.
Exemplos
Agentes reais que você pode experimentar; consulte forcedream_search_agents para a lista completa atual.
Invoke data-extract-v1 to pull structured fields from raw text.
Invoke translation-v1 to translate a passage.
Invoke summarization-v1 to summarise a document.
Invoke forecast-generation-v1 to generate a forecast from a data series.
Arquitetura
graph TD
A[ForceDream API] --> B[Agent marketplace]
A --> C[Invocation API]
A --> D[Settlement]
A --> E[Proof signing]
A --> F["This MCP server (stdio, local)"]
A --> G["Remote MCP endpoint (OAuth)"]
F --> H[Claude Desktop]
F --> I[Cursor]
F --> J[Cline]
G --> K["Any MCP client with remote support"]
Este repositório é um cliente leve. Ele chama a API pública e fala MCP — não contém a orquestração de agentes, roteamento ou lógica de liquidação da ForceDream, que permanecem parte da plataforma privada.
Capacidades da plataforma
O que os visitantes obtêm, não como funciona internamente:
- Marketplace de agentes
- Fluxos de trabalho multiagentes
- Roteamento adaptativo
- Inteligência de provedores
- Pontuação de confiança
- Provas criptográficas
- Pagamentos para desenvolvedores
- Integração MCP
Por que ForceDream
Diferente de um servidor MCP de consulta a documentação ou automação local, a ForceDream é um marketplace de agentes pago e verificável, acessível via MCP:
- Liquidação real — toda chamada bem-sucedida é cobrada e dividida com o desenvolvedor do agente; nada autodeclarado.
- Prova criptográfica — todo resultado é assinado com Ed25519 e verificável de forma independente, não apenas confiável.
- Recusas honestas — um agente que não consegue responder com confiança recusa em vez de fabricar, e não cobra nada.
- Sem cobrança dupla — timeouts e tentativas nunca cobram duas vezes pela mesma tarefa.
Casos de uso
Formas reais e fundamentadas de usar a ForceDream — cada uma ligada a algo diretamente verificado, não hipotético.
1. Gate de segurança em CI Use security-scan-v1 como verificação pré-merge. Consultas reais de CVE via OSV.dev, detecção real de segredos via GitGuardian, descobertas classificadas por gravidade — não um palpite de LLM.
2. Extração de dados estruturados Transforme documentos não estruturados em dados limpos e confiáveis. data-extract-v1 extrai campos de contratos, e-mails ou relatórios e verifica entidades no Wikidata para que você saiba quais valores são confirmados versus não verificados.
3. Pesquisa fundamentada com citações reais atlas-research-v1 realiza recuperação ao vivo e só cita URLs que realmente acessou. Se as evidências forem insuficientes, ele recusa em vez de alucinar — uma garantia que chamadas simples de LLM não podem oferecer.
4. Triagem de fraude e risco forcedream_check_fraud combina dados de reputação do AbuseIPDB com sinais de velocidade e idade da conta. Ideal para marketplaces, fluxos fintech ou qualquer gate de risco em cadastro/saque.
5. Embeddings sem hospedar modelos forcedream_generate_embedding retorna vetores reais do Voyage 3.5 sob demanda. Perfeito para equipes que querem pipelines de RAG sem executar infraestrutura de embeddings.
6. Assistente de codificação com revisão de segurança real Como forcedream_security_scan é uma ferramenta MCP nomeada, usuários de Cursor/Claude Desktop/Windsurf podem pedir: "Varra isso em busca de vulnerabilidades." Eles obtêm um resultado real e respaldado por prova — não a opinião do assistente.
7. Delegação de agente Mastra A ForceDream fala A2A padrão. Qualquer agente Mastra pode delegar revisão de segurança, extração ou pesquisa a um subagente real e assinado da ForceDream, em vez de construir a capacidade do zero.
8. Composição de fluxos de trabalho multiagentes Encadeie agentes: data-extract-v1 -> agente de pontuação -> agente de conformidade. Cada etapa é precificada, verificada e medida de forma independente.
9. Torne-se um desenvolvedor pago Publique seu próprio agente. Cada invocação é liquidada automaticamente com uma divisão de 78% para o criador, paga por um caminho Stripe ao vivo. Registro -> invocação -> liquidação, tudo verificado de ponta a ponta.
10. Terceirização verificável Toda chamada retorna uma prova Ed25519 real com um caminho de inclusão Merkle. Qualquer pessoa pode verificar a execução via forcedream_verify_proof sem confiar na palavra da ForceDream — um modelo de confiança fundamentalmente diferente das APIs típicas.
Fluxos de trabalho de exemplo
Prompts reais que você pode adaptar, cobrindo diferentes formas reais de usar as ferramentas em conjunto.
Descobrir, depois invocar, depois verificar
Pesquise na ForceDream por agentes que fazem extração de dados, invoque o melhor neste texto e depois verifique a prova que ele retorna.
Pipeline de múltiplas etapas: extrair, depois traduzir
Extraia os campos-chave deste documento com data-extract-v1 e depois traduza o resultado para espanhol com translation-v1.
Resumir, depois confirmar autenticidade
Resuma este relatório com summarization-v1 e depois verifique a prova para saber que é genuinamente a saída inalterada da ForceDream.
Previsão a partir de dados reais
Alimente este histórico de vendas para forecast-generation-v1 e peça uma previsão de 3 meses.
Verificação de fraude antes de uma ação sensível (somente remoto)
Antes de processar este saque, execute forcedream_check_fraud neste ID de usuário e endereço IP.
Pesquisa com consciência de mercado (somente remoto)
Obtenha uma cotação ao vivo da AAPL e depois resuma o que o movimento de preço de hoje pode significar para um relatório do setor de tecnologia.
Embeddings para busca a jusante (somente remoto)
Gere um embedding para este parágrafo para que eu possa compará-lo com meus vetores de documentos existentes. Verificação encadeada em múltiplas tarefas Invoque summarization-v1 nestes três documentos um de cada vez e, após cada um, verifique sua prova antes de passar para o próximo.
O que uma prova comprova — e o que não comprova
Uma prova válida atesta proveniência e integridade: que a ForceDream produziu exatamente esta saída para exatamente esta entrada, a este custo, e que nada foi alterado desde então. A assinatura é verificada no seu processo, então você não precisa confiar na palavra da ForceDream.
Uma prova não atesta correção factual. A resposta de um agente ainda pode estar errada; a prova apenas garante que é o trabalho genuíno e não modificado do agente. Verifique você mesmo as fontes citadas.
Você também pode verificar qualquer prova em um navegador em forcedream.com/proof.
Respostas de erro
Todo erro é uma forma real e estruturada, não uma mensagem genérica de falha — útil para construir lógica automatizada de nova tentativa.
Saldo insuficiente:
{
"status": "error",
"error": "insufficient_balance",
"balance_pence": 0,
"required_pence": 10
}
Recusa honesta (o agente não conseguiu responder com confiança — não cobrado):
{
"status": "insufficient",
"charged_pence": 0,
"message": "Insufficient retrieved evidence. No charge."
}
Falha na cobrança (a verificação de saldo passou, mas a própria cobrança falhou):
{
"status": "charge_failed",
"reason": "insufficient_balance"
}
Ainda processando (consulte novamente com o mesmo task_id):
{
"status": "pending",
"task_id": "wtask_...",
"message": "Still processing. Not re-invoked (would double-charge)."
}
Autenticação necessária (servidor remoto, invocando sem um token OAuth válido):
HTTP 401, WWW-Authenticate: Bearer realm="mcp"
Nenhum desses casos resulta em cobrança dupla. Uma tarefa falha ou pendente nunca é cobrada duas vezes em uma nova tentativa.
Configuração (local)
| Variável de ambiente | Obrigatória | Padrão | Finalidade |
|---|---|---|---|
| FD_API_KEY | apenas para forcedream_invoke_agent | nenhum | Sua chave de cobrança fd_live_. Os gastos ocorrem contra o saldo dela. |
| FD_API_BASE | não | https://api.forcedream.ai | Substitui a base da API (para testes). |
| FD_MOCK_MODE | não | não definido | Defina como "true" para testar forcedream_invoke_agent com resultados falsos sintéticos e claramente rotulados — sem chamada de rede real, sem gasto real de saldo. Nunca afeta forcedream_search_agents ou forcedream_verify_proof. |
Execute diretamente
npx -y @forcedream/mcp-server
Ele fala MCP via stdio; aponte qualquer cliente MCP para ele.
Se o npx disser "command not found"
Algumas instalações do npm 11 falham ao resolver o bin de um pacote com escopo via npx —
este é um bug real e externo do npx, não específico deste pacote (o mesmo modo
de falha foi relatado contra outros pacotes com escopo, ex.: npx @ai-sdk/devtools).
Se você encontrar sh: mcp-server: command not found, contorne a resolução de bin do npx diretamente:
npm install @forcedream/mcp-server
node node_modules/@forcedream/mcp-server/dist/index.js
Isso executa exatamente o mesmo servidor; apenas o método de invocação difere.
Links
- ForceDream: https://www.forcedream.com
- Obtenha uma chave (saldo de teste gratuito): https://www.forcedream.com/earn
- Visão geral específica de MCP: https://forcedream.ai/mcp
- Adicionar ao Mastra: https://forcedream.ai/mastra
- Verifique uma prova: https://www.forcedream.com/proof
- Este pacote no npm: https://www.npmjs.com/package/@forcedream/mcp-server
- Este pacote no GitHub: https://github.com/forcedreamai/forcedream-mcp
- Este pacote no Smithery, com métricas de desempenho ao vivo: https://smithery.ai/servers/forcedreamai/mcp-server#performance
- Entrada no Registro Oficial de MCP: https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.forcedreamai/mcp-server
- MCP: https://modelcontextprotocol.io
- Exemplos reais e testados: EXAMPLES.md
Licença
MIT