Pip Package Readme MCP Server

pip包README MCP服务器

 ](https://www.npmjs.com/package/pip-package-readme-mcp-server) ](https://www.npmjs.com/package/pip-package-readme-mcp-server) ](https://github.com/elchika-inc/pip-package-readme-mcp-server)

MCP（模型上下文协议）服务器，使AI助手能够从PyPI获取有关Python包的全面信息，包括README内容、包元数据和搜索功能。

特性

• 包README检索：从PyPI上托管的Python/pip包中获取带使用示例的格式化README内容
• 包裹信息：获取全面的包元数据，包括依赖关系、版本、统计信息和维护者信息
• 程序包搜索：通过包类型、流行度和相关性进行高级过滤来搜索PyPI
• 智能缓存：智能缓存系统，可优化API的使用并提高响应时间
• GitHub集成：与GitHub API无缝集成，在包链接到GitHub存储库时增强README获取
• 错误处理：具有自动重试逻辑和回退策略的强大错误处理

MCP客户端配置

将此服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "pip-package-readme": {
      "command": "npx",
      "args": ["pip-package-readme-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

备注：The GITHUB_TOKEN 是可选的，但建议在从GitHub获取README内容时使用更高的API速率限制。

可用工具

get_package_readme

检索Python包的全面README内容和使用示例。

参数：

{
  "package_name": "requests",
  "version": "latest",
  "include_examples": true
}

• package_name （string，必填）：Python包名称
• version （字符串，可选）：特定包版本或“最新”（默认：“最新的”）
• include_examples （布尔值，可选）：包括使用示例和代码片段（默认值：true）

退货： 格式化的README内容，包括安装说明、使用示例和API文档。

get_package_info

从PyPI获取详细的包元数据、依赖关系和统计信息。

参数：

{
  "package_name": "django",
  "include_dependencies": true,
  "include_dev_dependencies": false
}

• package_name （string，必填）：Python包名称
• include_dependencies （布尔值，可选）：包括运行时依赖关系（默认值：true）
• include_dev_dependencies （布尔值，可选）：包括开发依赖关系（默认值：false）

退货： 包元数据，包括版本信息、维护者、许可证、下载统计数据和依赖关系树。

搜索包

在PyPI中搜索具有高级过滤功能的包。

参数：

{
  "query": "web framework django",
  "limit": 20,
  "quality": 0.8
}

• query （字符串，必填）：搜索词（包名称、描述、关键字）
• limit （number，可选）：返回的最大结果数（默认值：20，最大值：250）
• quality （数字，可选）：最低质量分数过滤器（0-1）

退货： 包含名称、描述、下载次数和相关性得分的匹配包列表。

错误处理

服务器优雅地处理常见错误场景：

• 未找到包：返回带有包名称建议的明确错误消息
• 速率限制：实现指数回退的自动重试
• 网络超时：具有重试逻辑的可配置超时
• 包名称无效：验证包名称格式并提供指导
• GitHub API失败：GitHub集成失败时的回退策略

许可证

麻省理工学院