MCP Server Pacman

🚀 MCP 服务器 Pacman

MCP 服务器 Pacman 是一款强大的服务工具，它集成了多种包管理接口，支持对 PyPI、npm、crates.io、Docker Hub 和 Terraform Registry 等的查询与操作。通过它，用户可以方便地获取各类包的信息，同时具备缓存和日志管理等实用功能，有效提升开发和管理效率。

🚀 快速开始

安装

可以通过以下两种方式安装 MCP 服务器 Pacman：

从源码安装

git clone https://github.com/yourusername/mcp-server-pacman.git
cd mcp-server-pacman
pip install -r requirements.txt

使用 pip 安装

pip install mcp-server-pacman

启动服务

从源码安装后启动

python -m mcp_server.app

使用 pip 安装后启动

mcp-server-run

✨ 主要特性

• 多包管理接口集成：支持 PyPI、npm、crates.io、Docker Hub 和 Terraform Registry 等包管理平台的查询与操作。
• 缓存机制：默认使用内存缓存，可扩展支持 Redis 或其他存储方案。
• 日志记录：内置日志系统，默认输出到控制台，可配置文件日志记录和日志轮转策略。
• 灵活配置：支持通过配置文件和环境变量进行灵活配置。

📦 安装指南

系统要求

• 操作系统：支持 Linux、macOS 或 Windows（推荐使用 Linux 环境）。
• Python 版本：Python 3.6 及以上版本。
• 依赖管理：建议使用 pip 进行包管理。

安装步骤

方法一：从源码安装

1. 克隆仓库

git clone https://github.com/yourusername/mcp-server-pacman.git
cd mcp-server-pacman

2. 安装依赖

pip install -r requirements.txt

3. 配置环境变量（可选）

export MCP_SERVER_PORT=4001
export LOG_LEVEL=DEBUG

4. 启动服务

python -m mcp_server.app

方法二：使用 pip 安装

1. 安装包

pip install mcp-server-pacman

2. 启动服务

mcp-server-run

配置说明

• 配置文件：项目的主配置文件位于 config/settings.py，可根据需要修改其中的各项设置。
• 环境变量：某些配置可以通过环境变量覆盖，具体请参考环境变量参考。

💻 使用示例

查询 PyPI 包信息

# 搜索包
curl -X POST http://localhost:4001/pypi/search \
-d '{"query": "requests"}'

# 获取包详情
curl http://localhost:4001/pypi/package/requests

npm 包查询

# 搜索 npm 包
curl -X POST http://localhost:4001/npm/search \
-d '{"query": "@vue/core"}'

# 获取包下载量
curl http://localhost:4001/npm/downloads/@vue/core

📚 详细文档

功能模块

数据提供者接口

• PyPI：提供 Python 包信息查询功能。
• npm：支持 npm 包搜索与详情获取。
• crates.io：集成 Rust 语言包 registry。
• Docker Hub：提供 Docker 镜像索引服务。
• Terraform Registry：支持 Terraform 模块查询。

缓存机制

默认使用内存缓存，可扩展支持 Redis 或其他存储方案。

日志记录

内置日志系统，默认输出到控制台，可配置文件日志记录和日志轮转策略。

项目结构

代码目录结构

src/mcp_server_pacman/
├── models/             # 数据模型定义
├── providers/          # 第三方服务接口实现
│   ├── pypi.py         # PyPI 接口方法
│   ├── npm.py          # npm 接口方法
│   ├── crates.py       # crates.io 接口方法
│   ├── dockerhub.py    # Docker Hub 接口方法
│   └── terraform.py    # Terraform Registry 接口方法
├── utils/              # 工具函数集合
│   ├── cache.py        # 缓存相关功能
│   ├── constants.py    # 全局常量定义
│   └── parsers.py      # HTML 解析工具
├── __init__.py         # 包初始化文件
├── __main__.py         # 程序入口点
└── server.py           # MCP 服务器实现

测试目录结构

tests/
├── integration/        # 集成测试用例（调用真实 API）
├── models/             # 数据模型验证测试
├── providers/          # 提供商接口功能测试
└── utils/              # 工具函数测试

开发指南

环境准备

• 安装 Python 3.8+。
• 安装开发依赖：

pip install -r requirements.txt

运行测试

# 单元测试运行
pytest tests/unit/

# 集成测试运行
pytest tests/integration/

代码格式检查

black .
flake8 .

文献引用

如需参考本项目实现细节，可查阅以下资源：

• ModelContextProtocol 标准文档
• Pacman 设计规范

🔧 技术细节

配置文件

默认配置如下：

{
  "port": 4001,
  "cache_type": "memory",
  "log_level": "info"
}

核心组件

配置管理

settings.py 包含所有配置参数，如端口号、缓存类型等。

提供商接口

• pypi.py：实现与 PyPI 的交互，包括搜索和包信息查询。
• npm.py：实现与 npm registry 的交互，包括搜索和包版本管理。

开发流程

代码开发

1. 创建功能模块：

touch providers/your_provider.py

2. 编写实现逻辑，遵循现有代码风格。
3. 完成后提交到仓库，并确保通过所有测试用例。

测试开发

1. 新增功能时编写单元测试。

pytest tests/test_your_provider.py -v

2. 确保测试覆盖率达到要求（如 80%）。
3. 定期运行测试，确保代码质量。

打包与发布

打包步骤

1. 创建 setup.py 文件：

from setuptools import setup, find_packages

setup(
    name="mcp-server-pacman",
    version="0.1",
    packages=find_packages(),
    install_requires=[
        "requests>=2.25.1",
        "gunicorn>=19.9.0"
    ],
)

2. 打包：

python setup.py sdist bdist_wheel

3. 上传到私有仓库或 PyPI。

📄 许可证

本项目遵循 MIT 协议开源：

MIT License

Copyright (c) [年份] [版权持有者]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.