Simple MCP Gem

简单MCP

用于测试和开发目的的最小、快速和可靠的模型上下文协议（MCP）服务器实现。

概述

在Ruby应用程序进程中运行的最小MCP服务器。为构建可以与代码库一起发展的自定义AI工具提供了基础。

实验： 自定义MCP工具、人工智能辅助工作流和智能代码交互。

为什么是可嵌入宝石？

大多数MCP服务器作为单独的进程运行。这个gem通过在您的应用程序中运行来探索一种不同的方法：

• 共享运行时：访问项目加载的gem和Ruby环境
• 工作空间意识：工具知道项目的根目录上下文
• 可扩展基础：构建项目特定工具的简单架构
• 未来潜力：与Ruby LSP、Rails和其他工具进行更深入集成的基础

当人工智能工具理解您的特定代码库和业务领域时，您可以构建什么？

安装

添加到Ruby应用程序的Gemfile：

group :development do
  gem "simple-mcp", path: "simple-mcp-gem"
end

然后运行：

bundle install

配置

克劳德代码

创建 .claude/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "simple-mcp": {
      "command": "bundle",
      "args": ["exec", "simple-mcp"],
      "cwd": "/path/to/your/project",
      "env": {}
    }
  }
}

光标

使用与上述相同的格式添加到MCP设置或配置文件中。

用法

命令行

# Show help
bundle exec simple-mcp --help

# Show version
bundle exec simple-mcp --version

# Start MCP server (for testing)
bundle exec simple-mcp

MCP工具

gem提供了一个工具：

hello_world_tool

向提供的名称问好或默认为“World”。

参数：

• name （可选）：要问候的姓名

示例响应：

{"type": "text", "text": "Hello, World!"}
{"type": "text", "text": "Hello, Alice!"}

发展

需求

• Ruby 3.0+
• 打包工具
• RSpec（测试）
• RuboCop（棉绒）

设置

bundle install

测试

# Run all tests
bundle exec rspec

# Run with coverage
bundle exec rspec --format documentation

代码质量

# Run RuboCop
bundle exec rubocop

# Check syntax
ruby -c exe/simple-mcp

手动测试

# Test initialization
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {"tools": {}}}}' | bundle exec simple-mcp

# Test tool listing
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}' | bundle exec simple-mcp

# Test tool call
echo '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "hello_world_tool", "arguments": {"name": "Test"}}}' | bundle exec simple-mcp

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

致谢

免责声明

所有文档，包括此文件，都是在人工智能的帮助下生成的。