convez.ai
MCP ServerIntegração & APIsIntermediário
cssnr

Urban Dictionary MCP

cssnr/urban-dictionary-mcp

Acesse definições do Urban Dictionary via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe o Urban Dictionary para consultas de gírias e expressões informais. Permite que agentes Claude acessem definições de palavras e frases do dicionário online de forma programática.

Instalação

$npx convez-ai cssnr/urban-dictionary-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 5 meses
Versão
0.0.4
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar significados de gírias e expressões coloquiais
  • Enriquecer contexto em conversas sobre linguagem informal
  • Validar termos e expressões populares em análises de conteúdo

Veredito

MCP bem estruturado que integra o Urban Dictionary ao Claude. Útil para contexto linguístico informal, mas com aplicações limitadas a casos específicos de análise de linguagem e gírias.

README

A tradução para o português deste README ainda está na fila.

GitHub Release Version PyPI Version Image Latest Image Size Deployment PyPi Workflow Build Workflow Deploy Workflow Release GitHub Last Commit GitHub Repo Size GitHub Top Language GitHub Contributors GitHub Issues GitHub Discussions GitHub Forks GitHub Repo Stars GitHub Org Stars Discord Ko-fi

Urban Dictionary MCP

MCP Server exposing the Urban Dictionary via the Model Context Protocol.

Setup

This can be run in Local CLI mode or Remote server mode.

Local

In CLI mode using uv.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "urban-dictionary": {
      "type": "local",
      "command": ["uvx", "urban-dictionary-mcp"]
    }
  }
}

In CLI mode using Python pip.

pip install urban-dictionary-mcp
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "urban-dictionary": {
      "type": "local",
      "command": ["urban-dictionary-mcp"]
    }
  }
}

Remote

With Docker run.

docker run --rm -p 80:8000 ghcr.io/cssnr/urban-dictionary-mcp:latest

With Docker Compose.

services:
  app:
    image: ghcr.io/cssnr/urban-dictionary-mcp:latest
    ports:
      - '80:8000'

With Python from source.

uv sync
uv run uvicorn urban_dictionary_mcp.server:app --app-dir src --host 0.0.0.0 --port 8000
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "urban-dictionary": {
      "type": "remote",
      "url": "http://localhost/mcp"
    }
  }
}

Note: Set the url to the host you are running the server on.

Deploy to Render

For a Docker Swarm + Traefik example see the docker-compose-swarm.yaml.

For a Portainer Deploy workflow see the .github/workflows/deploy.yaml.

Configure

This is for advanced configuration only.

VariableDescriptionDefault
HISHEL_CACHE_PATHPath cache database file./hishel_cache.db
HISHEL_CACHE_TTLCache TTL in seconds1209600
STATELESS_HTTPEnable stateless HTTP modetrue

Boolean True Values (case-insensitive): 1, on, t, true, y, yes

In Docker the cache path is /data/hishel_cache.db so you can mount /data as a volume.

Development

Sync project.

uv sync

Run local server.

run cli

Run remote server (live reload).

run dev

Point your client to: http://localhost:8000/mcp

Run remote Docker Compose (live reload).

run compose

Point your client to: http://localhost/mcp

You can set the PORT environment variable.

Building

Docker Image

To build and test the docker image run.

bash build.sh
docker compose up

Point your client to: http://localhost/mcp

Python Package

This builds the bdist and wheel, if you have a use for it...

run build

Support

If you run into any issues or need help getting started, please do one of the following:

Features Issues Discussions Discord

Contributing

Please consider making a donation to support the development of this project and additional open source projects.

Ko-fi

For a full list of current projects visit: https://cssnr.github.io/

Ver o original no GitHub

Bom para

Relacionados