ContextMCP

ContextMCP

Servidor MCP auto-hospedado para sua documentação. Indexe sua documentação de todas as fontes e sirva-a via Model Context Protocol (MCP) e API REST.

Início Rápido

# Scaffold a new project
npx contextmcp init my-docs-mcp

# Follow the prompts, then:
cd my-docs-mcp
npm install

# Configure your API keys
cp .env.example .env
# Edit .env with your PINECONE_API_KEY and an embedding provider key
# (OPENAI_API_KEY for provider: openai, or GEMINI_API_KEY for provider: gemini)

# Configure your documentation sources
# Edit config.yaml

# Index your documentation
npm run reindex

# Edit the cloudflare-worker
# Deploy the MCP server
cd cloudflare-worker
npm install
npm run deploy

O que é ContextMCP?

ContextMCP cria uma base de conhecimento pesquisável a partir da sua documentação, que assistentes de IA podem consultar via Model Context Protocol (MCP).

Tipos de Conteúdo Suportados

Parser	Tipos de Conteúdo	Exemplos
mdx	Documentação MDX/JSX	Mintlify, Fumadocs, Docusaurus
markdown	Arquivos Markdown simples	READMEs, CHANGELOGs
openapi	Especificações OpenAPI/Swagger	Referências de API

Como Funciona

1. Parse - Extraia conteúdo da sua documentação, APIs e READMEs
2. Chunk - Divida em blocos semânticos otimizados para busca
3. Embed - Gere embeddings usando OpenAI ou Gemini
4. Store - Envie para o banco de vetores Pinecone
5. Search - Consulte via MCP a partir de assistentes de IA

Ecossistema

Adicione uma interface de chat com ContextChat

ContextMCP serve para recuperação; combine-o com ContextChat para dar à sua documentação um widget "Pergunte à IA" incorporável e pronto para uso. ContextChat é um único Cloudflare Worker que consulta seu endpoint /search do ContextMCP e transmite respostas com citações inline — adicione-o a qualquer site ou página de documentação com uma única tag <script>.

Estrutura do Repositório

contextmcp/
├── packages/
│   ├── cli/              # npx contextmcp (npm package)
│   ├── template/         # Project template (scaffolded to users)
│   └── website/          # contextmcp.ai documentation site
└── deployments/
    └── dodopayments/     # Dodo Payments specific deployment

Pacotes

Pacote	Descrição	Publicado
packages/cli	Ferramenta de scaffolding via CLI	✅ npm: contextmcp
packages/template	Modelo de projeto	(copiado pela CLI)
packages/website	Site de documentação	(implantado no Vercel)

Desenvolvimento

Pré-requisitos

• Node.js 18+

Configuração

# Install all dependencies
npm install

# Development
npm run dev:website     # Run website locally
npm run dev:cli         # Watch CLI for changes

# Build
npm run build:website   # Build website
npm run build:cli       # Build CLI

# Type checking
npm run typecheck       # Check all packages

Documentação

Visite contextmcp.ai/docs para documentação completa.

Contribuição

Aceitamos contribuições! Consulte CONTRIBUTING.md para diretrizes sobre como contribuir com este projeto.

Licença

Este projeto está licenciado sob a Licença Apache 2.0 — consulte o arquivo LICENSE para detalhes.