Ai Pair Programmer MCP

🚀 AI配对编程MCP服务器（Ruby版）

本项目是AI配对编程MCP（模型上下文协议）服务器的Ruby实现，它提供了由AI驱动的代码审查、头脑风暴、性能分析和安全审查等工具，助力开发者更高效地完成编程工作。

🚀 快速开始

前提条件

• Ruby 3.0及以上版本
• OpenRouter API密钥

自动安装

服务器使用内联捆绑器自动安装所需的gem包，需要的gem包如下：

• fast-mcp - Ruby MCP服务器框架
• ruby_llm - 统一的AI模型接口

配置

1. 设置你的OpenRouter API密钥：

export OPENROUTER_API_KEY="your_api_key_here"

运行服务器

ruby ./server.rb

服务器将执行以下操作：

• 首次运行时自动安装缺失的gem包
• 以STDIO传输方式启动，供MCP客户端连接
• 将日志输出到STDERR，应由你的MCP主机保存。

注意事项

如果在启动Claude Code时MCP未能正常启动，可能是由于超时导致的。这是因为捆绑器正在安装依赖项。要解决此问题，可以设置环境变量MCP_TIMEOUT=10000（即10秒），或者先在终端中启动MCP服务器。

✨ 主要特性

本服务器提供了5种由AI驱动的工具：

1. pair - 通用协作与问题解决
2. review - 全面的代码审查，并提供可操作的反馈
3. brainstorm - 创造性的构思和解决方案探索
4. review_performance - 性能分析与优化建议
5. review_security - 聚焦安全的代码审查和漏洞检测

📦 安装指南

前提条件

• Ruby 3.0+
• 一个OpenRouter API密钥

自动安装

服务器使用内联捆绑器进行自动的gem安装。所需的gem包括：

• fast-mcp - Ruby MCP服务器框架
• ruby_llm - 统一的AI模型接口

配置

设置你的OpenRouter API密钥：

export OPENROUTER_API_KEY="your_api_key_here"

运行服务器

ruby ./server.rb

服务器会在首次运行时自动安装缺失的gem，以STDIO传输方式为MCP客户端启动，并将日志记录到STDERR，你的MCP主机应保存这些日志。

若在启动Claude Code时MCP无法启动，可能是超时问题，这是因为捆绑器正在安装依赖项。可设置环境变量MCP_TIMEOUT=10000（10秒），或者先在终端启动MCP服务器。

💻 使用示例

连接到MCP客户端后，你可以进行以下操作：

基础用法

代码审查

请根据最佳实践审查这段Ruby代码，并指出潜在问题：

def process_data(items)
  items.map { |item| item.upcase }
end

性能分析

你能分析这段代码的性能瓶颈吗？

def find_duplicates(array)
  duplicates = []
  array.each do |item|
    if array.count(item) > 1 && !duplicates.include?(item)
      duplicates << item
    end
  end
  duplicates
end

安全审查

请检查这段身份验证代码是否存在安全漏洞：

def authenticate(username, password)
  user = User.find_by(username: username)
  if user && user.password == password
    session[:user_id] = user.id
    true
  else
    false
  end
end

头脑风暴

我需要一些改进我的Ruby on Rails应用用户引导流程的想法。目前的流程有60%的用户流失率。

通用协作

我在解决这个算法问题上遇到了困难。你能帮我一步步思考吗？

📚 详细文档

模型配置

服务器通过OpenRouter支持以下AI模型：

MCP客户端配置

Claude桌面版

在你的claude_desktop_config.json文件中添加以下内容：

{
  "mcpServers": {
    "AiPairProgrammer": {
      "command": "ruby",
      "args": ["/path/to/server.rb"]
    }
  }
}

🔧 技术细节

服务器基于以下组件构建：

• FastMcp - 支持STDIO传输的Ruby MCP服务器框架
• RubyLLM - 通过OpenRouter与AI模型进行交互的统一接口
• 内联捆绑器 - 自动安装gem包，便于部署

📄 许可证

本项目采用MIT许可证。

参考项目

由Eduard开发的AI助手MCP服务器 https://github.com/eduardm/ai_pairs_with_ai

贡献指南

1. Fork仓库
2. 创建功能分支
3. 进行修改
4. 使用ruby test_server.rb进行测试
5. 提交拉取请求