协议服务器集合

一个基于Ruby的Model Context Protocol (MCP)服务器集合,提供数学计算、时间功能、系统监控、Git操作、任务管理和Swagger API生成等多种功能。

  • by IvanShamatov
  • Ruby
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 IvanShamatov/mcp

使用说明

MCP服务器集合

用Ruby编写的用于各种系统操作的Model Context Protocol(MCP)服务器集合。

服务器

1. 简单的MCP服务器(simple_mcp_server.rb)

带有数学计算和时间函数的基础MCP服务器。

安装:

gem install json

工具:

  • get_current_time - 返回当前时间
  • calculate - 进行数学计算

2. 简单快速的MCP服务器(simple_fast_mcp.rb)

使用(某技术/工具)的简化版MCP服务器 fast_mcp gem.(在德语中常作为“Gemeinde”的缩写,意为“社区”或“市政区”)可翻译为“社区”或“市政区”。

安装:

gem install fast_mcp

工具:

  • get_current_time - 返回当前时间
  • calculate - 进行数学计算

3. 系统监控MCP(system_monitor_mcp.rb)

使用(工具)监控系统资源和性能 fast_mcp gem.(在德语中通常作为缩写,但具体含义需根据上下文确定,常见如“Gemeinde”(社区)的缩写等,若直接翻译此缩写本身无固定中文对应,需结合语境)。

安装:

gem install fast_mcp

工具:

  • check_disk_space - 检查磁盘上的可用空间
  • check_memory - 检查内存使用情况
  • check_cpu - 检查CPU负载
  • system_info - 显示系统信息

4. Git MCP 服务器(git_mcp.rb)

使用Git进行仓库操作 fast_mcp gem.(这个缩写在德语中通常表示“Gemeinde”,即“社区”或“市政区”的意思,但具体翻译需根据上下文确定)。

安装:

gem install fast_mcp git

工具:

  • git_status - 显示git仓库的状态
  • git_log - 显示提交历史
  • git_branches - 所有git分支的列表

5. 任务管理器 MCP(task_manager_mcp.rb)

使用具有优先级级别和状态追踪的任务管理 fast_mcp gem.(德语缩写,意为“gemeinsam”,即“共同”或“一起”)。

安装:

gem install fast_mcp json fileutils

工具:

  • list_tasks - 显示所有任务
  • add_task - 添加新任务
  • complete_task - 将任务标记为已完成
  • delete_task - 删除任务
  • task_stats - 显示任务统计

6. Swagger MCP 封装器(swagger_mcp_wrapper.rb)

自动从Swagger/OpenAPI规范中生成MCP工具。

安装:

gem install json net-http uri yaml

使用方法:

ruby swagger_mcp_wrapper.rb <swagger_path> <api_base_url>

使用

启动单独服务器

# Simple MCP Server (базовая версия)
ruby simple_mcp_server.rb

# Simple Fast MCP Server
ruby simple_fast_mcp.rb

# System Monitor MCP
ruby system_monitor_mcp.rb

# Git MCP Server
ruby git_mcp.rb

# Task Manager MCP
ruby task_manager_mcp.rb

# Swagger MCP Wrapper
ruby swagger_mcp_wrapper.rb ./swagger.json http://localhost:3000

与MCP客户端的集成

这些服务器可以通过在MCP客户端的配置文件中进行设置,与MCP兼容的客户端进行集成。

Cursor的配置示例:

{
  "mcpServers": {
    "simple-fast": {
      "command": "ruby",
      "args": ["/path/to/simple_fast_mcp.rb"]
    },
    "system-monitor": {
      "command": "ruby",
      "args": ["/path/to/system_monitor_mcp.rb"]
    },
    "git-ops": {
      "command": "ruby",
      "args": ["/path/to/git_mcp.rb"]
    },
    "task-manager": {
      "command": "ruby",
      "args": ["/path/to/task_manager_mcp.rb"]
    },
    "swagger-api": {
      "command": "ruby",
      "args": ["/path/to/swagger_mcp_wrapper.rb", "./swagger.json", "http://localhost:3000"]
    }
  }
}

依赖关系

  • Ruby 2.7及以上版本
  • fast_mcp gem(适用于基于fast_mcp的服务器)
  • git gem(用于Git操作)
  • Ruby 标准库(json、yaml、net/http、fileutils)

开发

要在现有服务器上添加新工具:

  1. 在相应的类中添加工具定义
  2. 实现相应的方法
  3. 添加相应的错误处理
  4. 使用MCP客户端进行测试

许可证

麻省理工学院许可证