Servidor Pacman MCP

Un servidor de Protocolo de Contexto de Modelo que ofrece funciones de consulta de índices de paquetes. Este servidor permite a los LLM buscar y recuperar información de repositorios de paquetes como PyPI, npm, crates.io, Docker Hub y Terraform Registry.

Herramientas disponibles

• search_package - Busca paquetes en los índices de paquetes

  • index (cadena, obligatorio): Índice del paquete a buscar ("pypi", "npm", "crates", "terraform")

  • query (cadena, obligatoria): nombre del paquete o consulta de búsqueda

  • limit (entero, opcional): número máximo de resultados a devolver (predeterminado: 5, máximo: 50)

• package_info - Obtener información detallada sobre un paquete específico

  • index (cadena, obligatorio): índice del paquete a consultar ("pypi", "npm", "crates", "terraform")

  • name (cadena, obligatorio): nombre del paquete

  • version (cadena, opcional): versión específica para la que obtener información (predeterminado: la más reciente)

• search_docker_image : busca imágenes de Docker en Docker Hub

  • query (cadena, obligatoria): Nombre de la imagen o consulta de búsqueda

  • limit (entero, opcional): número máximo de resultados a devolver (predeterminado: 5, máximo: 50)

• docker_image_info : obtenga información detallada sobre una imagen de Docker específica

  • name (cadena, obligatorio): nombre de la imagen (por ejemplo, usuario/repositorio o biblioteca/repositorio)

  • tag (cadena, opcional): etiqueta de imagen específica (predeterminada: última)

• terraform_module_latest_version : obtener la última versión de un módulo de Terraform

  • name (cadena, obligatorio): Nombre del módulo (formato: espacio de nombres/nombre/proveedor)

Indicaciones

• búsqueda_pypi

  • Buscar paquetes de Python en PyPI

  • Argumentos:

    • query (cadena, obligatoria): nombre del paquete o consulta de búsqueda

• información de pypi

  • Obtener información sobre un paquete específico de Python

  • Argumentos:

    • name (cadena, obligatorio): nombre del paquete

    • version (cadena, opcional): versión específica

• búsqueda_npm

  • Buscar paquetes de JavaScript en npm

  • Argumentos:

    • query (cadena, obligatoria): nombre del paquete o consulta de búsqueda

• información npm

  • Obtener información sobre un paquete de JavaScript específico

  • Argumentos:

    • name (cadena, obligatorio): nombre del paquete

    • version (cadena, opcional): versión específica

• cajas de búsqueda

  • Busque paquetes de Rust en crates.io

  • Argumentos:

    • query (cadena, obligatoria): nombre del paquete o consulta de búsqueda

• información de cajas

  • Obtenga información sobre un paquete específico de Rust

  • Argumentos:

    • name (cadena, obligatorio): nombre del paquete

    • version (cadena, opcional): versión específica

• búsqueda_docker

  • Buscar imágenes de Docker en Docker Hub

  • Argumentos:

    • query (cadena, obligatoria): Nombre de la imagen o consulta de búsqueda

• información del contenedor

  • Obtener información sobre una imagen de Docker específica

  • Argumentos:

    • name (cadena, obligatorio): nombre de la imagen (por ejemplo, usuario/repositorio)

    • tag (cadena, opcional): etiqueta específica

• búsqueda_terraform

  • Busque módulos de Terraform en el Registro de Terraform

  • Argumentos:

    • query (cadena, obligatoria): nombre del módulo o consulta de búsqueda

• información de terraform

  • Obtenga información sobre un módulo específico de Terraform

  • Argumentos:

    • name (cadena, obligatorio): Nombre del módulo (formato: espacio de nombres/nombre/proveedor)

• terraform_última_versión

  • Obtenga la última versión de un módulo específico de Terraform

  • Argumentos:

    • name (cadena, obligatorio): Nombre del módulo (formato: espacio de nombres/nombre/proveedor)

Instalación

Uso de uv (recomendado)

Al usar uv , no se requiere ninguna instalación específica. Usaremos uvx para ejecutar directamente mcp-server-pacman .

Uso de PIP

Alternativamente, puede instalar mcp-server-pacman a través de pip:

Después de la instalación, puedes ejecutarlo como un script usando:

Usando Docker

También puedes utilizar la imagen de Docker:

Configuración

Configurar para Claude.app

Añade a tu configuración de Claude:

Configurar para VS Code

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open User Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp es necesaria cuando se utiliza el archivo mcp.json .

Personalización - Agente de usuario

De forma predeterminada, el servidor utilizará el agente de usuario:

Esto se puede personalizar agregando el argumento --user-agent=YourUserAgent a la lista de args en la configuración.

Desarrollo

Ejecución de pruebas

• Ejecutar todas las pruebas:

  uv run pytest -xvs

• Ejecutar categorías de pruebas específicas:

  # Run all provider tests uv run pytest -xvs tests/providers/ # Run integration tests for a specific provider uv run pytest -xvs tests/integration/test_pypi_integration.py # Run specific test class uv run pytest -xvs tests/providers/test_npm.py::TestNPMFunctions # Run a specific test method uv run pytest -xvs tests/providers/test_pypi.py::TestPyPIFunctions::test_search_pypi_success

• Comprobar el estilo del código:

  uv run ruff check . uv run ruff format --check .

• Código de formato:

  uv run ruff format .

Depuración

Puede usar el inspector MCP para depurar el servidor. Para instalaciones uvx:

O si ha instalado el paquete en un directorio específico o está desarrollando en él:

Proceso de liberación

El proyecto utiliza GitHub Actions para lanzamientos automatizados:

1. Actualice la versión en pyproject.toml

2. Crea una nueva etiqueta con git tag vX.YZ (por ejemplo, git tag v0.1.0 )

3. Empuje la etiqueta con git push --tags

Esto automáticamente:

• Verifique que la versión en pyproject.toml coincida con la etiqueta

• Ejecutar pruebas y comprobaciones de pelusa

• Construir y publicar en PyPI

• Construya y publique en Docker Hub como oborchers/mcp-server-pacman:latest y oborchers/mcp-server-pacman:XYZ

Estructura del proyecto

La base del código está organizada en la siguiente estructura:

Las pruebas siguen una estructura similar:

Contribuyendo

Invitamos a todos a contribuir para expandir y mejorar mcp-server-pacman. Ya sea que desee agregar nuevos índices de paquetes, mejorar la funcionalidad existente o mejorar la documentación, su aporte es valioso.

Para ver ejemplos de otros servidores MCP y patrones de implementación, consulte: https://github.com/modelcontextprotocol/servers

¡Aceptamos solicitudes de incorporación de cambios! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras para que mcp-server-pacman sea aún más potente y útil.

Licencia

mcp-server-pacman está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.