Status Mcp.rb

🚀 status_mcp

このRuby gemは、MCP（Model Context Protocol）サーバーツールを介して、[awesome - status](https://github.com/amkisko/awesome - status)からステータスページ情報を提供します。Cursor IDEやClaude DesktopなどのMCP互換クライアントや、その他の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

サーバーは起動し、MCPプロトコルを使用してSTDIN/STDOUTを介して通信します。

✨ 主な機能

• ステータスページ情報: 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 で歓迎されます。 詳細については、CONTRIBUTING.mdを参照してください。

🔒 セキュリティ

セキュリティ上の脆弱性を発見した場合は、責任を持って報告してください。詳細については、SECURITY.mdを参照してください。

📄 ライセンス

このgemは、MITライセンスの条件の下でオープンソースとして利用可能です。