简单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-mcpMCP工具
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许可证-有关详细信息，请参阅许可证文件。
致谢
免责声明
所有文档，包括此文件，都是在人工智能的帮助下生成的。