Servidor MCP de Búsqueda en Diccionario

Un servidor Model Context Protocol mínimo, construido con el SDK oficial de Python. Expone una única herramienta, define, que busca la definición de una palabra en inglés usando la API gratuita de dictionaryapi.dev.

Este proyecto se creó como ejercicio de aprendizaje para entender cómo se estructuran los servidores MCP, cómo se comunican con los clientes y cómo se implementan públicamente.

Qué hace

• Expone una única herramienta: define(word: str) -> str

• Dada una palabra, devuelve su categoría gramatical y su definición

• No requiere clave de API ni autenticación

Related MCP server: Hello World MCP FastAPI Endpoint

Requisitos

• Python 3.10+

• uv (recomendado) o pip

Configuración (local)

# 1. Clone this repo
git clone <your-repo-url>
cd my-mcp-server

# 2. Install dependencies
uv sync

Ejecutarlo localmente

Opción A — Inspector MCP (herramienta de prueba visual, la más sencilla para principiantes):

uv run mcp dev server.py

Esto abre un inspector basado en navegador donde puedes llamar a la herramienta define directamente y ver la solicitud/respuesta sin necesidad de un cliente de IA completo.

Opción B — Conectar con Claude Desktop:

Añade esto a tu archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "dictionary-lookup": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/my-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

Reinicia Claude Desktop y luego pregunta algo como: "Usa la herramienta de diccionario para definir 'ephemeral'."

Ejemplo de uso

Entrada: define("ephemeral") Salida: ephemeral (adjective): lasting for a very short time.

Despliegue

Este servidor está publicado en Smithery: <link una vez desplegado>

Para desplegar tu propia copia:

1. Sube este repositorio a GitHub.

2. Asegúrate de que server.py sea compatible con el transporte streamable-http para el alojamiento remoto.

3. Alójalo (p. ej., Render/Railway) o usa el flujo de publicación de Smithery.

4. En Smithery, elige "Publicar vía URL" y apunta a la URL de tu servidor alojado.

Por qué este proyecto

Creado para aprender los fundamentos de MCP: cómo un cliente descubre las herramientas de un servidor, cómo se realiza y se responde una llamada a una herramienta, y cómo un servidor en funcionamiento se comparte públicamente a través de un marketplace como Smithery.