ContextMCP

ContextMCP

Servidor MCP autoalojado para tu documentación. Indexa tu documentación de todas las fuentes y sírvela a través del Model Context Protocol (MCP) y la API REST.

Inicio 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

¿Qué es ContextMCP?

ContextMCP crea una base de conocimiento buscable a partir de tu documentación que los asistentes de IA pueden consultar a través del Model Context Protocol (MCP).

Tipos de contenido admitidos

Analizador	Tipos de contenido	Ejemplos
mdx	documentación MDX/JSX	Mintlify, Fumadocs, Docusaurus
markdown	archivos Markdown simples	READMEs, CHANGELOGs
openapi	especificaciones OpenAPI/Swagger	documentación de referencia de API

Cómo funciona

1. Analizar - Extrae contenido de tus documentos, APIs y READMEs
2. Fragmentar - Divide en fragmentos semánticos optimizados para búsqueda
3. Generar embeddings - Genera embeddings usando OpenAI o Gemini
4. Almacenar - Sube a la base de datos vectorial Pinecone
5. Buscar - Consulta vía MCP desde asistentes de IA

Ecosistema

Añade una interfaz de chat con ContextChat

ContextMCP proporciona recuperación; combínalo con ContextChat para dar a tus documentos un widget "Ask AI" integrable y listo para usar. ContextChat es un único Cloudflare Worker que consulta tu endpoint /search de ContextMCP y transmite respuestas con citas en línea — agrégalo a cualquier sitio o página de documentación con una etiqueta <script>.

Estructura del repositorio

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

Paquetes

Paquete	Descripción	Publicado
packages/cli	herramienta de andamiaje CLI	✅ npm: contextmcp
packages/template	plantilla de proyecto	(copiado por CLI)
packages/website	sitio de documentación	(desplegado en Vercel)

Desarrollo

Requisitos previos

• Node.js 18+

Configuración

# 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

Documentación

Visita contextmcp.ai/docs para obtener la documentación completa.

Contribuciones

¡Agradecemos las contribuciones! Consulta CONTRIBUTING.md para obtener las pautas sobre cómo contribuir a este proyecto.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0; consulta el archivo LICENSE para obtener más detalles.