status_mcp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 90ebc8381fe57ee101567bd64e18bc376d891bedbfa5082e82588494390576b3
+  data.tar.gz: 7ac9f6100c97338d2e1db437baf9cd4a5c9c54170d449b76324a94c59f10fd81
+SHA512:
+  metadata.gz: 3a080023fd1c648d0820ebbf1701689dc8fb7fff2e6bfcb371b7a75b8b38de92d76c4aa2c67c34309a2b672cd399f4315c08ab3d06b13411c6eb35a296ab9350
+  data.tar.gz: 10b97c76cea65e18588eff67c1874d3803113e5ca6c4559af0f35c72bbf389e1230a4caffec32c89e8df732ddc993d1fed98cfd9fcdec9121d599c6d87a6dde4

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# CHANGELOG
+
+## 0.1.0 (2025-11-26)
+
+- Initial release
+- MCP server with tools:
+  - `search_services`: Search for services by name
+  - `get_service_details`: Get detailed status links for a specific service
+  - `list_services`: List all available services
+- Data update script `bin/update_status_list` to fetch data from `awesome-status`
+- Comprehensive test suite with RSpec
+- Full documentation and CI/CD setup

data/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,129 @@
+# status_mcp
+
+[![Gem Version](https://badge.fury.io/rb/status_mcp.svg)](https://badge.fury.io/rb/status_mcp) [![Test Status](https://github.com/amkisko/status_mcp.rb/actions/workflows/test.yml/badge.svg)](https://github.com/amkisko/status_mcp.rb/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/amkisko/status_mcp.rb/graph/badge.svg)](https://codecov.io/gh/amkisko/status_mcp.rb)
+
+Ruby gem providing status page information from [awesome-status](https://github.com/amkisko/awesome-status) via MCP (Model Context Protocol) server tools. Integrates with MCP-compatible clients like Cursor IDE, Claude Desktop, and other MCP-enabled tools.
+
+Sponsored by [Kisko Labs](https://www.kiskolabs.com).
+
+<a href="https://www.kiskolabs.com">
+  <img src="kisko.svg" width="200" alt="Sponsored by Kisko Labs" />
+</a>
+
+## Requirements
+
+- **Ruby 3.1 or higher** (Ruby 3.0 and earlier are not supported)
+
+## Quick Start
+
+```bash
+gem install status_mcp
+```
+
+### Cursor IDE Configuration
+
+For Cursor IDE, create or update `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "status": {
+      "command": "gem",
+      "args": ["exec", "status_mcp"],
+      "env": {
+        "RUBY_VERSION": "3.4.7"
+      }
+    }
+  }
+}
+```
+
+**Note**: Using `gem exec` ensures the correct Ruby version is used.
+
+### Claude Desktop Configuration
+
+For Claude Desktop, edit the MCP configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "status": {
+      "command": "gem",
+      "args": ["exec", "status_mcp"],
+      "env": {
+        "RUBY_VERSION": "3.4.7"
+      }
+    }
+  }
+}
+```
+
+**Note**: After updating the configuration, restart Claude Desktop for changes to take effect.
+
+### Running the MCP Server manually
+
+After installation, you can start the MCP server immediately:
+
+```bash
+# With bundler
+gem install status_mcp && bundle exec status_mcp
+
+# Or if installed globally
+status_mcp
+```
+
+The server will start and communicate via STDIN/STDOUT using the MCP protocol.
+
+## Features
+
+- **Status Page Information**: Access to over 1700 status page links from `awesome-status`
+- **MCP Server Integration**: Ready-to-use MCP server with tools for searching and retrieving status page details
+- **No Authentication Required**: All data is bundled with the gem
+- **Offline Capable**: Once installed, the data is available locally
+
+## MCP Tools
+
+The MCP server provides the following tools:
+
+1. **search_services** - Search for services by name
+   - Parameters: `query` (string)
+
+2. **get_service_details** - Get detailed status links for a specific service
+   - Parameters: `name` (string)
+
+3. **list_services** - List all available services (limited to first 50 if too many)
+   - Parameters: `limit` (optional integer, default: 50)
+
+## Development
+
+```bash
+# Install dependencies
+bundle install
+
+# Run tests
+bundle exec rspec
+
+# Run tests across multiple Ruby versions
+bundle exec appraisal install
+bundle exec appraisal rspec
+
+# Run linting
+bundle exec standardrb --fix
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/amkisko/status_mcp.rb.
+
+For more information, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Security
+
+If you discover a security vulnerability, please report it responsibly. See [SECURITY.md](SECURITY.md) for details.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).