Real-time web search, URL content extraction, and cited multi-source research from You.com's production search index. Free keyless tier available.You.com

https://github.com/youdotcom-oss/dx-toolkitBúsqueda web en tiempo real, extracción de contenido de URL e investigación citada de múltiples fuentes desde el índice de búsqueda de producción de You.com. Nivel gratuito sin clave disponible.

GitHub
24

Documentación

@youdotcom-oss/mcp

Puente STDIO solo-binario para el servidor MCP alojado de You.com en https://api.you.com/mcp.

Este paquete no registra herramientas localmente y no contiene lógica de herramientas REST. Su única función es actuar como proxy del tráfico MCP STDIO hacia el servidor remoto alojado.

Inicio rápido

// Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.)
// Free tier — no API key, no signup.
{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Si tu cliente es compatible con MCP remoto, apúntalo directamente a https://api.you.com/mcp?profile=free — no se necesita ningún proceso local.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Con autenticación (todas las herramientas predeterminadas):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_API_KEY": "<your-key>" }
    }
  }
}

Claude Code

# Free tier
claude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp

# Authenticated
claude mcp add you -e YDC_API_KEY=<your-key> -- npx @youdotcom-oss/mcp

Cursor

Añade a ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Windsurf

Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

VS Code

Añade a tu mcp.json de usuario o espacio de trabajo:

{
  "servers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Cualquier cliente MCP (remoto)

Si tu cliente soporta HTTP transmisible, omite el puente local:

https://api.you.com/mcp?profile=free

Con autenticación:

https://api.you.com/mcp
Authorization: Bearer <your-key>

Instalación

bun add @youdotcom-oss/mcp

O ejecútalo directamente:

npx @youdotcom-oss/mcp

Entorno

  • YDC_API_KEY Opcional. Se envía como Authorization: Bearer <key>.
  • YDC_PROFILE Opcional. Cuando se establece en free, enruta el puente a https://api.you.com/mcp?profile=free.
  • YDC_ALLOWED_TOOLS Opcional. IDs de herramientas alojadas separados por comas para exponer a través de https://api.you.com/mcp?tools=....

YDC_PROFILE tiene prioridad sobre YDC_ALLOWED_TOOLS.

Exposición de herramientas

La URL MCP alojada predeterminada expone cuatro herramientas:

  • you-search
  • you-contents
  • you-balance
  • you-discover

Hay dos herramientas adicionales disponibles bajo petición:

  • you-finance
  • you-research

Solicita herramientas adicionales explícitamente con tools. tools limita el conjunto de herramientas visibles.

Hoy, profile=free es un modo sin clave. Anula tools y expone you-search y you-discover.

Ejemplos:

  • Conjunto de herramientas predeterminado: https://api.you.com/mcp
  • Solo finanzas: https://api.you.com/mcp?tools=you-finance
  • Búsqueda más finanzas: https://api.you.com/mcp?tools=you-search,you-finance
  • Solo investigación: https://api.you.com/mcp?tools=you-research
  • Perfil gratuito (sin clave): https://api.you.com/mcp?profile=free

Enlaces

Contribuciones

La configuración de desarrollo y las convenciones de código se encuentran en AGENTS.md; el flujo de contribuciones y las convenciones de PR se encuentran en CONTRIBUTING.md. Se aceptan problemas y PRs.

Licencia

MIT — consulta LICENSE.