MeshVault Connectors

npx add-mcp 'https://thefiredev.com/mcp'

MeshVault Connectors

O MeshVault Connectors oferece ao seu assistente de IA ferramentas MCP somente leitura para protocolos de EMS, juízes e tribunais, dados de saúde pública e dimensionamento de modelos.

Adicionar ao Claude Code

claude mcp add --transport http meshvault https://thefiredev.com/mcp/try

Isso adiciona o endpoint de teste sem chave: 10 chamadas de ferramenta por dia UTC por rede. Outros clientes e autenticação.

Grátis: uma chave permite 100 chamadas por dia em todas as 18 ferramentas. Pro: US$ 19/mês para 5.000 chamadas por dia, com as mesmas ferramentas. Obtenha uma chave gratuita ou escolha Pro. O código-fonte do servidor é MIT; o self-hosting é separado dos planos hospedados.

Gravado a partir de uma execução real em um ambiente Omabox novo. A demonstração mostra a conexão e a descoberta de ferramentas, não uma chamada de ferramenta; o tempo ocioso é reduzido.

Grupos de ferramentas

Grupo	Ferramentas	Fonte
ems	ems_search_protocols, ems_get_protocol, ems_list_agencies, ems_coverage	Guia de Protocolo API pública do site (somente leitura)
legal	legal_search_judges, legal_get_judge, legal_judge_recent_cases, legal_search_courts, legal_court_judges	JudgeFinder API JSON
health	health_npi_lookup, health_drug_label, health_drug_recalls, health_drug_adverse_events	CMS NPPES NPI Registry, FDA openFDA
models	models_fit_check, models_estimate_vram, models_gguf_files, models_search_hf, models_gpu_catalog	Hugging Face Hub mais cálculo de VRAM integrado

Toda ferramenta é anotada como somente leitura. Resultados de EMS são para educação e referência, não direção médica; dados de saúde não são aconselhamento médico; dados legais não são aconselhamento jurídico. Cada resposta repete o aviso.

Como usar

URL do servidor: https://thefiredev.com/mcp (página inicial, documentação e preços: https://thefiredev.com/connectors)

# Claude Code
claude mcp add --transport http meshvault https://thefiredev.com/mcp --header "Authorization: Bearer $MESHVAULT_API_KEY"
# Codex CLI (~/.codex/config.toml)
# [mcp_servers.meshvault]
# url = "https://thefiredev.com/mcp"
# bearer_token_env_var = "MESHVAULT_API_KEY"

Conectores personalizados do Claude e do ChatGPT usam OAuth: adicione a URL, e a página de login solicita uma chave ou cria uma gratuita. /mcp/try não exige credenciais e permite 10 chamadas por dia por rede. Gemini CLI: gemini extensions install https://github.com/thefiredev-cloud/meshvault-connectors (defina MESHVAULT_API_KEY).

Cursor, VS Code e outros clientes que leem um mcp.json:

{
  "mcpServers": {
    "meshvault": { "url": "https://thefiredev.com/mcp" }
  }
}

O cliente abre o login OAuth no primeiro uso. Nome do registro: io.github.thefiredev-cloud/meshvault-connectors no registro oficial de MCP; também listado no Glama.

Planos

Plano	Chamadas por dia UTC	Preço
Anônimo (/mcp/try)	10	grátis
Chave gratuita	100	grátis
Pro	5.000	US$ 19 / mês (Stripe Checkout)

Apenas tools/call conta. Chamadas rejeitadas por entrada inválida ou que falham por indisponibilidade de um serviço upstream são reembolsadas.

Arquitetura

api/index.ts          Vercel Function entry (all dynamic routes, via vercel.json rewrites)
src/app.ts            Hono routes: /mcp, /mcp/try, /oauth/*, /api/*, /billing/success, webhook
src/mcp.ts            Stateless MCP server per request, quota + error handling around every tool
src/oauth.ts          OAuth 2.1: DCR (stateless signed client_id), code + PKCE S256, rotating refresh tokens
src/keys.ts           API keys (sha256 at rest), one-time sealed reveal after purchase
src/quota.ts          Per-day counters with compare-and-swap
src/store.ts          Private Vercel Blob store (ETag CAS), file and memory stores for dev and tests
src/billing.ts        Checkout, portal, webhook: issue / upgrade / revoke / downgrade keys, idempotent
src/tools/*.ts        The four tool groups
public/               Landing page, docs, privacy, terms

O estado reside em um único armazenamento privado Vercel Blob (keys/, usage/, customers/, events/, oauth/). Gravações usam ETag compare-and-swap, então chamadas concorrentes não podem exceder uma cota.

Tokens de atualização OAuth são reivindicados por uma atualização compare-and-swap. Um token reutilizado, incluindo uma solicitação de atualização concorrente perdedora, revoga a família. Tokens de acesso verificam essa família em cada solicitação, então a revogação não espera a expiração de uma hora do token.

Comportamento de cobrança

• Checkout com uma chave existente faz upgrade dessa chave. Cancelamento faz downgrade para Grátis.
• Checkout sem chave emite uma nova chave Pro, mostrada uma vez na página de confirmação (selada com AES-256-GCM por 24 horas). Cancelamento a revoga.
• A execução ocorre tanto pelo webhook quanto pela página de confirmação. Ambos verificam o status atual da assinatura no Stripe, o cliente e o preço Pro configurado antes de conceder acesso; snapshots tardios de eventos e links de sucesso reutilizados não podem restaurar uma assinatura cancelada.
• Eventos de webhook tratados: checkout.session.completed, checkout.session.async_payment_succeeded, customer.subscription.updated, customer.subscription.deleted.

Desenvolvimento

pnpm install
pnpm test            # unit and integration tests (MemoryStore, fake Stripe, real MCP SDK client)
pnpm typecheck
pnpm dev             # http://127.0.0.1:8787 with a file-backed store
pnpm exec tsx scripts/smoke.ts http://127.0.0.1:8787     # calls all 18 tools like a customer

As variáveis de ambiente estão listadas em .env.example. Use chaves de modo de teste do Stripe até ir para produção intencionalmente; stripe listen --forward-to localhost:8787/api/stripe/webhook fornece um segredo de webhook local.

Implantação

Duas formas suportadas:

Projeto Vercel próprio. Importe este repositório (framework: Other; as configurações estão em vercel.json), adicione um armazenamento Blob privado, defina as variáveis de .env.example, adicione o endpoint de webhook https://<host>/api/stripe/webhook para os quatro eventos acima.

Montado em outro site (como o thefiredev.com o executa). node scripts/export-mount.mjs --out <host repo> --prefix /connectors grava uma Function Vercel empacotada (api/connectors.js) e as páginas estáticas em public/connectors/; --rewrites <file> também grava os vercel.json reescritas que o host deve conter. O host define variáveis CONNECTORS_* (CONNECTORS_APP_SECRET, CONNECTORS_PUBLIC_BASE_URL, CONNECTORS_LANDING_PATH, CONNECTORS_STRIPE_SECRET_KEY, CONNECTORS_STRIPE_PRICE_PRO, CONNECTORS_STRIPE_WEBHOOK_SECRET) e um armazenamento Blob conectado com o prefixo de variável CONNECTORS_BLOB. O serviço é dono de /mcp, /oauth/*, /.well-known/oauth-*, /billing/*, /api/keys, /api/usage, /api/checkout, /api/billing, /api/stripe, /health.

Depois publique server.json com mcp-publisher.

Licença

MIT. Dados de fontes de terceiros mantêm seus próprios termos; veja cada fonte.