Status Mcp.rb

🚀 status_mcp

status_mcp 是一個 Ruby gem，它通過 MCP（Model Context Protocol）服務器工具，從 awesome-status 提供狀態頁面信息。該 gem 可與支持 MCP 的客戶端集成，如 Cursor IDE、Claude Desktop 以及其他啟用 MCP 的工具。本項目由 Kisko Labs 贊助。

🚀 快速開始

安裝

gem install status_mcp

Cursor IDE 配置

在 Cursor IDE 中，在項目裡創建或更新 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "status": {
      "command": "gem",
      "args": ["exec", "status_mcp"],
      "env": {
        "RUBY_VERSION": "3.4.7"
      }
    }
  }
}

注意：使用 gem exec 可確保使用正確的 Ruby 版本。

Claude Desktop 配置

在 Claude Desktop 中，編輯 MCP 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "status": {
      "command": "gem",
      "args": ["exec", "status_mcp"],
      "env": {
        "RUBY_VERSION": "3.4.7"
      }
    }
  }
}

注意：更新配置後，重啟 Claude Desktop 以使更改生效。

手動運行 MCP 服務器

安裝完成後，可立即啟動 MCP 服務器：

# 使用 bundler
gem install status_mcp && bundle exec status_mcp

# 或全局安裝後
status_mcp

服務器將啟動，並通過 STDIN/STDOUT 使用 MCP 協議進行通信。

✨ 主要特性

• 狀態頁面信息：可訪問來自 awesome-status 的 1700 多個狀態頁面鏈接。
• MCP 服務器集成：提供即用型 MCP 服務器，具備搜索和檢索狀態頁面詳情的工具。
• 無需身份驗證：所有數據都包含在 gem 中。
• 支持離線使用：安裝後，數據可在本地使用。

📚 詳細文檔

MCP 工具

MCP 服務器提供以下工具：

1. search_services - 按名稱搜索服務
   • 參數：query（字符串）
2. get_service_details - 獲取特定服務的詳細狀態鏈接
   • 參數：name（字符串）
3. list_services - 列出所有可用服務（如果數量過多，最多列出前 50 個）
   • 參數：limit（可選整數，默認值：50）

📦 安裝指南

環境要求

• Ruby 3.1 或更高版本（不支持 Ruby 3.0 及更早版本）

💻 使用示例

開發相關命令

# 安裝依賴
bundle install

# 運行測試
bundle exec rspec

# 在多個 Ruby 版本上運行測試
bundle exec appraisal install
bundle exec appraisal rspec

# 運行代碼檢查並修復
bundle exec standardrb --fix

🤝 貢獻指南

歡迎在 GitHub（https://github.com/amkisko/status_mcp.rb ）上提交 bug 報告和拉取請求。更多信息請參閱 CONTRIBUTING.md。

🔒 安全問題

如果發現安全漏洞，請負責任地報告。詳細信息請參閱 SECURITY.md。

📄 許可證

該 gem 以開源形式提供，遵循 MIT 許可證。