🎼 Composer MCP Server (非官方)

<p align="center"> <img src="https://gips0.baidu.com/it/u=2533215671,789174708&fm=3081&app=3081&f=PNG?w=290&h=356" alt="Composer Logo" width="200"> </p> <p align="center"> <b>通过AI驱动的Composer包安装增强您的PHP开发流程</b> </p> <p align="center"> <a href="#features">特性</a> • <a href="#setup">设置</a> • <a href="#usage">使用</a> • <a href="#how-it-works">工作原理</a> • <a href="#contributing">贡献</a> </p>

---

✨ 特性

• 一键包安装：使用单个命令安装任何Composer包
• 智能设置指南：自动从包的README中提取设置步骤
• 全面的包支持：内置了对流行的Laravel和Symfony包的支持
• 节省时间的指导：再也不错过关键的安装后步骤

🚀 设置

开始使用Composer MCP Server非常简单。只需将其添加到您的MCP客户端配置中（如Claude Desktop、Windsurf、Cursor等）：

{
  "mcpServers": {
    "composer-ai": {
      "command": "npx",
      "args": [
        "composer-mcp-server"
      ]
    }
  }
}

就这样！NPX命令会在需要时自动下载并运行Composer MCP Server，无需手动安装。

🔧 使用

配置完成后，您可以以自然的方式与AI助手交互来安装Composer包：

您：Composer AI 安装 laravel/sanctum

AI：[分析包并提供安装指令]
要安装 laravel/sanctum，请运行以下命令：

`composer require laravel/sanctum`

安装后，请完成以下额外设置步骤：
- 运行 `php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"` 来发布配置
- 运行 `php artisan migrate` 来创建所需的表

在后台，AI助手使用 install_package 工具：

install_package(package="laravel/sanctum", version="^3.0")

该工具会：

1. 生成正确的Composer命令来安装包
2. 分析包的README以提取设置指令
3. 提供一个全面的指南来完成安装

🧠 工作原理

Composer MCP Server利用模型上下文协议（MCP）扩展AI助手的PHP Composer能力。当您请求AI助手安装一个包时，会发生以下情况：

1. 您的请求（“Composer AI 安装 {package_name}”）被AI识别
2. AI调用由MCP服务器提供的 install_package 工具
3. MCP服务器检查Packagist上的包信息
4. 它从GitHub或GitLab获取包的README
5. 它智能地解析README以识别安装和设置指令
6. 如果README没有明确的指令，它会回退到常见包的内置知识
7. 格式化的安装和设置指令返回给AI
8. AI以帮助性的对话形式向您展示这些信息

整个过程在几秒钟内完成，为您节省了搜索文档和自己找出安装后步骤的时间。

🤝 贡献

欢迎贡献！如果您想为项目做出贡献：

# 克隆仓库
git clone https://github.com/jordandalton/composer-mcp-server.git

# 导航到项目目录
cd composer-mcp-server

# 安装依赖并构建
yarn install && yarn build

您可以这样帮助：

• 在回退系统中增加对更多PHP包的支持
• 改进README解析算法
• 增强错误处理和用户反馈
• 扩展工具的功能

📄 许可证

本项目采用MIT许可证——详情见LICENSE文件。

📱 联系

如果您觉得这个工具有用，随时可以联系创作者：

• Twitter/X: @jordankdalton
• Reddit: jdcarnivore

---

<p align="center"> 为PHP开发者制作 ❤️ </p>