Context7 Hoja de Referencia del Servidor MCP

## Descripción general

Context7 es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas de codificación de IA con acceso a documentación actualizada y específica de versión para más de 1000 bibliotecas y frameworks. Elimina la información desactualizada extrayendo documentación directamente de fuentes oficiales.

⚠️ Nota: Requiere herramientas de IA compatibles con MCP (Claude, Cursor, Windsurf, etc.)

Instalación

Instalación con NPM

Instalación con Docker

Desde el Código Fuente

Configuración de MCP

Cursor IDE

Claude Desktop

Windsurf IDE

VS Code con Continue.dev

Herramientas Disponibles

resolve-library-id

get-library-docs

Bibliotecas Compatibles

Frameworks Frontend

Frameworks Backend

Bases de Datos

Servicios en la Nube

Ejemplos de Uso

Búsqueda Básica de Documentación

Documentación Específica de Versión

Consultas Enfocadas en Temas

Comparaciones de Múltiples Bibliotecas

Opciones de Configuración

Variables de Entorno

Archivo de Configuración

Would you like me to fill in the remaining sections with placeholder translations or wait for specific content?```bash

Install globally

npm install -g @upstash/context7

Install locally in project

npm install @upstash/context7

Verify installation

npx @upstash/context7 —version


### Docker Installation
```bash
# Pull Docker image
docker pull mcp/context7

# Run Context7 server
docker run -p 3000:3000 mcp/context7

# Run with custom configuration
docker run -p 3000:3000 -v $(pwd)/config:/app/config mcp/context7

From Source

# Clone repository
git clone https://github.com/upstash/context7.git
cd context7

# Install dependencies
npm install

# Build and run
npm run build
npm start

MCP Configuration

Cursor IDE

// Add to Cursor MCP settings
\\\\{
  "mcpServers": \\\\{
    "context7": \\\\{
      "command": "npx",
      "args": ["@upstash/context7"],
      "env": \\\\{
        "CONTEXT7_API_KEY": "your-api-key"
      \\\\}
    \\\\}
  \\\\}
\\\\}

Claude Desktop

// ~/.claude/claude_desktop_config.json
\\\\{
  "mcpServers": \\\\{
    "context7": \\\\{
      "command": "npx",
      "args": ["@upstash/context7"],
      "env": \\\\{
        "CONTEXT7_API_KEY": "your-api-key"
      \\\\}
    \\\\}
  \\\\}
\\\\}

Windsurf IDE

// Add to Windsurf MCP configuration
\\\\{
  "mcpServers": \\\\{
    "context7": \\\\{
      "command": "npx",
      "args": ["@upstash/context7", "--port", "3000"],
      "env": \\\\{
        "CONTEXT7_API_KEY": "your-api-key"
      \\\\}
    \\\\}
  \\\\}
\\\\}

VS Code with Continue.dev

// .continue/config.json
\\\\{
  "mcpServers": [
    \\\\{
      "name": "context7",
      "command": "npx",
      "args": ["@upstash/context7"],
      "env": \\\\{
        "CONTEXT7_API_KEY": "your-api-key"
      \\\\}
    \\\\}
  ]
\\\\}

Available Tools

resolve-library-id

# Resolve library name to Context7 ID
# Input: General library name
# Output: Context7-compatible library ID

# Example usage in AI chat:
"Find the Context7 ID for React"
# Returns: /facebook/react

get-library-docs

# Fetch documentation for specific library
# Parameters:
# - context7CompatibleLibraryID (required)
# - topic (optional)
# - tokens (optional, default: 10000)

# Example usage in AI chat:
"Get React documentation for hooks"
# Uses: /facebook/react with topic "hooks"

Supported Libraries

Frontend Frameworks

# React ecosystem
/facebook/react
/vercel/next.js
/gatsbyjs/gatsby
/vuejs/vue
/nuxt/nuxt
/angular/angular

# State management
/reduxjs/redux
/pmndrs/zustand
/mobxjs/mobx
/vuejs/pinia

Backend Frameworks

# Node.js frameworks
/expressjs/express
/fastify/fastify
/nestjs/nest
/koajs/koa

# Python frameworks
/django/django
/pallets/flask
/fastapi/fastapi
/tornadoweb/tornado

# Other languages
/spring-projects/spring-boot
/rails/rails
/laravel/laravel

Databases

# SQL databases
/mongodb/docs
/prisma/prisma
/typeorm/typeorm
/sequelize/sequelize

# NoSQL databases
/redis/redis
/elastic/elasticsearch
/apache/cassandra

Cloud Services

# AWS services
/aws/aws-sdk-js
/aws/aws-cdk
/aws/aws-cli

# Google Cloud
/googleapis/google-cloud-node
/firebase/firebase-js-sdk

# Azure
/azure/azure-sdk-for-js
/azure/azure-cli

Usage Examples

Basic Documentation Lookup

// In AI chat with Context7 enabled:
"Show me the latest React useState documentation"

// Context7 automatically:
// 1. Resolves "React" to /facebook/react
// 2. Fetches current useState documentation
// 3. Provides up-to-date examples and API reference

Version-Specific Documentation

// Get specific version documentation
"Get Next.js 14 documentation for app router"

// Context7 provides:
// - Version 14 specific features
// - App router implementation details
// - Migration guides from pages router

Topic-Focused Queries

// Focus on specific topics
"Get MongoDB documentation for aggregation pipelines"

// Context7 returns:
// - Aggregation framework documentation
// - Pipeline stage references
// - Performance optimization tips

Multi-Library Comparisons

// Compare similar libraries
"Compare Prisma and TypeORM query builders"

// Context7 fetches:
// - Current Prisma query documentation
// - Current TypeORM query documentation
// - Enables accurate comparison

Configuration Options

Environment Variables

# API configuration
export CONTEXT7_API_KEY="your-api-key"
export CONTEXT7_PORT=3000
export CONTEXT7_HOST="localhost"

# Cache settings
export CONTEXT7_CACHE_TTL=3600
export CONTEXT7_CACHE_SIZE=1000

# Rate limiting
export CONTEXT7_RATE_LIMIT=100
export CONTEXT7_RATE_WINDOW=60

Configuration File

// context7.config.json
\\\\{
  "server": \\\\{
    "port": 3000,
    "host": "localhost"
  \\\\},
  "cache": \\\\{
    "ttl": 3600,
    "maxSize": 1000,
    "enabled": true
  \\\\},
  "rateLimit": \\\\{
    "requests": 100,
    "window": 60
  \\\\},
  "libraries": \\\\{
    "autoUpdate": true,
    "updateInterval": 86400
  \\\\}
\\\\}
```### Fuentes de Bibliotecas Personalizadas
```json
// Add custom documentation sources
\\\\{
  "customSources": [
    \\\\{
      "id": "/company/internal-lib",
      "name": "Internal Library",
      "url": "https://docs.company.com/internal-lib",
      "type": "markdown"
    \\\\}
  ]
\\\\}
```## Uso Avanzado
```javascript
// Use Context7 programmatically
const \\\\{ Context7Client \\\\} = require('@upstash/context7');

const client = new Context7Client(\\\\{
  apiKey: process.env.CONTEXT7_API_KEY
\\\\});

// Resolve library ID
const libraryId = await client.resolveLibraryId('React');
console.log(libraryId); // /facebook/react

// Get documentation
const docs = await client.getLibraryDocs(\\\\{
  libraryId: '/facebook/react',
  topic: 'hooks',
  tokens: 5000
\\\\});
```### Acceso Programático
```javascript
// Create custom MCP server with Context7
const \\\\{ MCPServer \\\\} = require('@modelcontextprotocol/sdk');
const \\\\{ Context7Client \\\\} = require('@upstash/context7');

const server = new MCPServer(\\\\{
  name: 'custom-context7',
  version: '1.0.0'
\\\\});

const context7 = new Context7Client();

server.addTool(\\\\{
  name: 'get-docs',
  description: 'Get documentation with custom processing',
  inputSchema: \\\\{
    type: 'object',
    properties: \\\\{
      library: \\\\{ type: 'string' \\\\},
      topic: \\\\{ type: 'string' \\\\}
    \\\\}
  \\\\},
  handler: async (\\\\{ library, topic \\\\}) => \\\\{
    const libraryId = await context7.resolveLibraryId(library);
    const docs = await context7.getLibraryDocs(\\\\{
      libraryId,
      topic,
      tokens: 8000
    \\\\});

    // Custom processing
    return processDocumentation(docs);
  \\\\}
\\\\});
```### Servidor MCP Personalizado
```javascript
// Webpack plugin for Context7
class Context7WebpackPlugin \\\\{
  apply(compiler) \\\\{
    compiler.hooks.beforeCompile.tapAsync('Context7Plugin', async (params, callback) => \\\\{
      // Update documentation cache before build
      await updateContext7Cache();
      callback();
    \\\\});
  \\\\}
\\\\}

// Vite plugin
export function context7Plugin() \\\\{
  return \\\\{
    name: 'context7',
    buildStart() \\\\{
      // Initialize Context7 for development
      initializeContext7();
    \\\\}
  \\\\};
\\\\}
```### Integración con Herramientas de Compilación
```bash
# Check server status
curl http://localhost:3000/health

# Check library availability
curl http://localhost:3000/libraries

# Test library resolution
curl -X POST http://localhost:3000/resolve \
  -H "Content-Type: application/json" \
  -d '\\\\{"libraryName": "React"\\\\}'
```## Monitoreo y Depuración
```json
\\\\{
  "logging": \\\\{
    "level": "info",
    "format": "json",
    "outputs": ["console", "file"],
    "file": \\\\{
      "path": "./logs/context7.log",
      "maxSize": "10MB",
      "maxFiles": 5
    \\\\}
  \\\\}
\\\\}
```### Verificaciones de Salud
```javascript
// Monitor Context7 performance
const \\\\{ Context7Monitor \\\\} = require('@upstash/context7/monitor');

const monitor = new Context7Monitor(\\\\{
  metricsInterval: 60000,
  alertThresholds: \\\\{
    responseTime: 5000,
    errorRate: 0.05
  \\\\}
\\\\});

monitor.on('alert', (alert) => \\\\{
  console.log('Context7 Alert:', alert);
  // Send to monitoring system
\\\\});
```### Configuración de Registro
```bash
# Server not starting
# Check port availability
netstat -an|grep 3000

# Check configuration
npx @upstash/context7 --validate-config

# Library not found
# Update library index
npx @upstash/context7 --update-libraries

# Slow responses
# Check cache status
curl http://localhost:3000/cache/stats
```### Monitoreo de Rendimiento
```bash
# Enable debug logging
export CONTEXT7_DEBUG=true
npx @upstash/context7

# Verbose output
npx @upstash/context7 --verbose

# Test specific library
npx @upstash/context7 --test-library /facebook/react
```## Resolución de Problemas
```bash
# Clear cache
curl -X DELETE http://localhost:3000/cache

# Warm cache for popular libraries
curl -X POST http://localhost:3000/cache/warm

# Cache statistics
curl http://localhost:3000/cache/stats
```### Problemas Comunes
```bash
# Use environment variables
export CONTEXT7_API_KEY="$(cat ~/.context7/api-key)"

# Rotate API keys regularly
npx @upstash/context7 --rotate-key

# Restrict API access
export CONTEXT7_ALLOWED_ORIGINS="https://your-domain.com"
```### Modo de Depuración
```json
\\\\{
  "security": \\\\{
    "cors": \\\\{
      "enabled": true,
      "origins": ["https://trusted-domain.com"]
    \\\\},
    "rateLimit": \\\\{
      "enabled": true,
      "requests": 100,
      "window": 60
    \\\\},
    "authentication": \\\\{
      "required": true,
      "methods": ["apiKey", "jwt"]
    \\\\}
  \\\\}
\\\\}
```### Gestión de Caché
```json
\\\\{
  "cache": \\\\{
    "strategy": "lru",
    "maxSize": 1000,
    "ttl": 3600,
    "compression": true,
    "persistence": \\\\{
      "enabled": true,
      "path": "./cache"
    \\\\}
  \\\\}
\\\\}
```## Consideraciones de Seguridad
```javascript
// Batch requests for better performance
const batchRequests = [
  \\\\{ library: 'React', topic: 'hooks' \\\\},
  \\\\{ library: 'Next.js', topic: 'routing' \\\\},
  \\\\{ library: 'TypeScript', topic: 'interfaces' \\\\}
];

const results = await context7.batchGetDocs(batchRequests);
```### Gestión de Claves API
https://github.com/upstash/context7### Seguridad de Red
https://modelcontextprotocol.io## Optimización de Rendimiento
https://docs.upstash.com### Estrategias de Caché
https://docs.anthropic.com/claude/docs/mcp### Optimización de Solicitudes
https://docs.cursor.com/mcp## Recursos
https://github.com/upstash/context7/tree/main/examples)