Documentación del paquete MCP Server
Un servidor MCP (Protocolo de contexto de modelo) que proporciona a los LLM un acceso eficiente a la documentación de paquetes en múltiples lenguajes de programación y capacidades de protocolo de servidor de lenguaje (LSP).
Características
- Soporte multilingüe :
- Paquetes Go a través de
go doc - Bibliotecas de Python a través de
help() - Paquetes NPM a través de documentación de registro (incluidos registros privados)
- Cajas de Rust a través de crates.io y docs.rs
- Análisis inteligente de documentación :
- Salida estructurada con descripción, uso y ejemplos
- Información enfocada para evitar la sobrecarga de contexto
- Soporte para búsquedas de símbolos/funciones específicas
- Capacidades de búsqueda exacta y difusa en toda la documentación
- Funciones de búsqueda avanzada :
- Buscar dentro de la documentación del paquete
- Coincidencia difusa para consultas flexibles
- Resultados sensibles al contexto con puntuación de relevancia
- Extracción de símbolos de los resultados de búsqueda
- Compatibilidad con el Protocolo de servidor de lenguaje (LSP) :
- Información sobre los símbolos de código al pasar el cursor
- Finalizaciones de código
- Diagnósticos (errores y advertencias)
- Actualmente es compatible con TypeScript/JavaScript
- Extensible para otros idiomas
- Rendimiento optimizado :
- Almacenamiento en caché integrado
- Análisis eficiente
- Huella mínima de memoria
Instalación
Para instalar automáticamente Package Docs para Claude Desktop a través de Smithery :
npx -y @smithery/cli install mcp-package-docs --client claude
Uso
Como servidor MCP
- Añade a tu configuración de MCP:
{
"mcpServers": {
"package-docs": {
"command": "npx",
"args": ["-y", "mcp-package-docs"],
"env": {
"ENABLE_LSP": "true" // Optional: Enable Language Server Protocol support
}
}
}
}
- La funcionalidad LSP incluye configuraciones predeterminadas para servidores de lenguaje comunes:
- TypeScript/JavaScript:
typescript-language-server --stdio - HTML:
vscode-html-language-server --stdio - CSS:
vscode-css-language-server --stdio - JSON:
vscode-json-language-server --stdio
Puede anular estos valores predeterminados si es necesario:
{
"mcpServers": {
"package-docs": {
"command": "npx",
"args": ["-y", "mcp-package-docs"],
"env": {
"ENABLE_LSP": "true",
"TYPESCRIPT_SERVER": "{\"command\":\"/custom/path/typescript-language-server\",\"args\":[\"--stdio\"]}"
}
}
}
}
- El servidor proporciona las siguientes herramientas:
buscar_documento_go / describir_paquete_go
Obtiene la documentación del paquete Go
{
"name": "describe_go_package",
"arguments": {
"package": "encoding/json", // required
"symbol": "Marshal" // optional
}
}
buscar_doc_python / describir_paquete_python
Obtiene la documentación del paquete de Python
{
"name": "describe_python_package",
"arguments": {
"package": "requests", // required
"symbol": "get" // optional
}
}
describe_rust_package
Obtiene la documentación de las cajas de Rust desde crates.io y docs.rs
{
"name": "describe_rust_package",
"arguments": {
"package": "serde", // required: crate name
"version": "1.0.219" // optional: specific version
}
}
buscar_documentos_del_paquete
Buscar dentro de la documentación del paquete
{
"name": "search_package_docs",
"arguments": {
"package": "requests", // required: package name
"query": "authentication", // required: search query
"language": "python", // required: "go", "python", "npm", "swift", or "rust"
"fuzzy": true // optional: enable fuzzy matching (default: true)
}
}
buscar_doc_npm / describir_paquete_npm
Obtiene la documentación de paquetes NPM de registros públicos y privados. Utiliza automáticamente el registro apropiado según la configuración de .npmrc.
{
"name": "describe_npm_package",
"arguments": {
"package": "axios", // required - supports both scoped (@org/pkg) and unscoped packages
"version": "1.6.0" // optional
}
}
La herramienta lee su archivo ~/.npmrc para determinar el registro correcto para cada paquete:
- Utiliza configuraciones de registro con alcance (por ejemplo, @mycompany=...)
- Admite registros privados (paquetes de GitHub, GitLab, Nexus, Artifactory, etc.)
- Vuelve al registro npm predeterminado si no se configura ningún registro personalizado
Ejemplo de configuraciones .npmrc:
registry=https://nexus.mycompany.com/repository/npm-group/
@mycompany:registry=https://nexus.mycompany.com/repository/npm-private/
@mycompany-ct:registry=https://npm.pkg.github.com/
Herramientas del Protocolo de Servidor de Lenguaje (LSP)
Cuando se habilita la compatibilidad con LSP, las siguientes herramientas adicionales están disponibles:
obtener_hover
Obtener información al pasar el cursor sobre una posición en un documento
{
"name": "get_hover",
"arguments": {
"languageId": "typescript", // required: language identifier (e.g., "typescript", "javascript")
"filePath": "src/index.ts", // required: path to the source file
"content": "const x = 1;", // required: content of the file
"line": 0, // required: zero-based line number
"character": 6, // required: zero-based character position
"projectRoot": "/path/to/project" // optional: project root directory
}
}
obtener_completaciones
Obtener sugerencias para completar una posición en un documento
{
"name": "get_completions",
"arguments": {
"languageId": "typescript", // required: language identifier
"filePath": "src/index.ts", // required: path to the source file
"content": "const arr = []; arr.", // required: content of the file
"line": 0, // required: zero-based line number
"character": 16, // required: zero-based character position
"projectRoot": "/path/to/project" // optional: project root directory
}
}
obtener_diagnósticos
Obtener información de diagnóstico (errores, advertencias) de un documento
{
"name": "get_diagnostics",
"arguments": {
"languageId": "typescript", // required: language identifier
"filePath": "src/index.ts", // required: path to the source file
"content": "const x: string = 1;", // required: content of the file
"projectRoot": "/path/to/project" // optional: project root directory
}
}
Ejemplo de uso en un LLM
Buscando documentación
// Looking up Go documentation
const goDocResult = await use_mcp_tool({
server_name: "package-docs",
tool_name: "describe_go_package",
arguments: {
package: "encoding/json",
symbol: "Marshal"
}
});
// Looking up Python documentation
const pythonDocResult = await use_mcp_tool({
server_name: "package-docs",
tool_name: "describe_python_package",
arguments: {
package: "requests",
symbol: "post"
}
});
// Looking up Rust documentation
const rustDocResult = await use_mcp_tool({
server_name: "package-docs",
tool_name: "describe_rust_package",
arguments: {
package: "serde"
}
});
// Searching within documentation
const searchResult = await use_mcp_tool({
server_name: "package-docs",
tool_name: "search_package_docs",
arguments: {
package: "serde",
query: "serialize",
language: "rust",
fuzzy: true
}
});
// Using LSP for hover information (when LSP is enabled)
const hoverResult = await use_mcp_tool({
server_name: "package-docs",
tool_name: "get_hover",
arguments: {
languageId: "typescript",
filePath: "src/index.ts",
content: "const axios = require('axios');\naxios.get",
line: 1,
character: 7
}
});
Requisitos
- Node.js >= 20
- Go (para la documentación del paquete Go)
- Python 3 (para la documentación del paquete Python)
- Conexión a Internet (para la documentación del paquete NPM y la documentación del paquete Rust)
- Servidores de idioma (para funcionalidad LSP):
- TypeScript/JavaScript:
npm install -g typescript-language-server typescript - HTML/CSS/JSON:
npm install -g vscode-langservers-extracted
Desarrollo
# Install dependencies
npm i
# Build
npm run build
# Watch mode
npm run watch
Contribuyendo
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/amazing-feature ) - Confirme sus cambios (
git commit -m 'Add some amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - Abrir una solicitud de extracción
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.