Urban Dictionary MCP
cssnr/urban-dictionary-mcp
Acesse definições do Urban Dictionary via MCP
Ver no GitHubServidor 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-mcp1 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
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.
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.
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.
| Variable | Description | Default |
|---|---|---|
HISHEL_CACHE_PATH | Path cache database file | ./hishel_cache.db |
HISHEL_CACHE_TTL | Cache TTL in seconds | 1209600 |
STATELESS_HTTP | Enable stateless HTTP mode | true |
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:
- Report an Issue: https://github.com/cssnr/urban-dictionary-mcp/issues
- Q&A Discussion: https://github.com/cssnr/urban-dictionary-mcp/discussions/categories/q-a
- Request a Feature: https://github.com/cssnr/urban-dictionary-mcp/issues/new?template=1-feature.yaml
- Chat with us on Discord: https://discord.gg/wXy6m2X8wY
Contributing
Please consider making a donation to support the development of this project and additional open source projects.
For a full list of current projects visit: https://cssnr.github.io/