@withinfocus/tba-mcp-server 1.0.4 → 1.1.0

package/README.md

@@ -11,31 +11,35 @@ A Model Context Protocol (MCP) server that provides access to The Blue Alliance
 - **Type Safety**: All responses validated with Zod schemas
 - **Comprehensive Coverage**: 35+ tools covering all major TBA API endpoints
 
-## Prerequisites
-
-- Node.js 24
-- [The Blue Alliance](https://www.thebluealliance.com/) API key
-
 ## Installation
 
-### From npm
+### npm (Recommended)
 
 ```bash
 npm install -g @withinfocus/tba-mcp-server
 ```
 
-### From source
+### Docker
+
+Pull the image from GitHub Container Registry:
+
+```bash
+docker pull ghcr.io/withinfocus/tba-mcp-server:latest
+```
+
+Or build locally:
 
 ```bash
 git clone https://github.com/withinfocus/tba-mcp-server.git
 cd tba-mcp-server
-npm ci
-npm run build
+docker build -t tba-mcp-server .
 ```
 
 ## Configuration
 
-Set your The Blue Alliance API key as an environment variable:
+1. Get an API key from [The Blue Alliance](https://www.thebluealliance.com/account)
+
+2. Set your API key as an environment variable:
 
 ```bash
 export TBA_API_KEY=your_api_key_here
@@ -49,6 +53,8 @@ TBA_API_KEY=your_api_key_here
 
 ## Usage
 
+### With npm
+
 Add to your MCP client configuration (e.g., Claude Desktop):
 
 ```json
@@ -65,6 +71,37 @@ Add to your MCP client configuration (e.g., Claude Desktop):
 }
 ```
 
+### With Docker
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "tba": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "-i",
+        "--init",
+        "-e",
+        "TBA_API_KEY=your_api_key_here",
+        "ghcr.io/withinfocus/tba-mcp-server:latest"
+      ]
+    }
+  }
+}
+```
+
+Or run directly:
+
+```bash
+docker run --rm -i --init \
+  -e TBA_API_KEY=your_api_key_here \
+  ghcr.io/withinfocus/tba-mcp-server:latest
+```
+
 ## Available Tools
 
 ### Team Information (24 tools)
@@ -73,45 +110,34 @@ Access comprehensive team data including profiles, participation history, events
 
 **Key tools**: `get_team`, `get_team_events`, `get_team_matches`, `get_team_awards`, `get_team_media`
 
-[View all team tools →](docs/TOOLS.md#team-information-tools)
-
 ### Event Information (19 tools)
 
 Query event details, participants, rankings, matches, and analytics.
 
 **Key tools**: `get_event`, `get_events`, `get_event_teams`, `get_event_rankings`, `get_event_matches`, `get_event_oprs`
 
-[View all event tools →](docs/TOOLS.md#event-information-tools)
-
 ### Match Information (3 tools)
 
 Retrieve detailed match data including scores, alliances, and robot tracking.
 
 **Key tools**: `get_match`, `get_match_simple`, `get_match_zebra`
 
-[View all match tools →](docs/TOOLS.md#match-information-tools)
-
 ### District Tools (8 tools)
 
 Access district rankings, events, and team information.
 
 **Key tools**: `get_districts`, `get_district_rankings`, `get_district_events`, `get_district_teams`
 
-[View all district tools →](docs/TOOLS.md#district-tools)
-
 ### General/Utility Tools (6 tools)
 
 Paginated team listings and API status information.
 
 **Key tools**: `get_teams`, `get_teams_by_year`, `get_status`
 
-[View all utility tools →](docs/TOOLS.md#generalutility-tools)
-
 ### Complete Documentation
 
 - **[All Tools](docs/TOOLS.md)** - Complete reference for all 35+ tools with parameters and examples
 - **[Data Schemas](docs/SCHEMAS.md)** - Detailed schema documentation for all response types
-- **[Development Guide](docs/DEVELOPMENT.md)** - Building, testing, and contributing
 
 ## Quick Examples
 
@@ -154,25 +180,9 @@ get_match(match_key: "2024casj_qm1")
 get_match_zebra(match_key: "2024casj_qm1")
 ```
 
-## Development
-
-See the [Development Guide](docs/DEVELOPMENT.md) for detailed instructions on:
+## Contributing
 
-- Building and testing
-- Adding new tools
-- Running unit and integration tests
-- Code standards and contribution guidelines
-
-Quick start:
-
-```bash
-npm ci                   # Install dependencies
-npm run build            # Build TypeScript
-npm test                 # Run unit tests
-npm run test:integration # Run integration tests
-npm run lint             # Check code quality
-npm run inspect          # Launch MCP inspector
-```
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing guidelines, and how to add new tools.
 
 ## Related Links
 

package/dist/index.js

@@ -20,7 +20,7 @@ async function runServer() {
         }
         server = new Server({
             name: 'The Blue Alliance MCP Server',
-            version: '1.0.4',
+            version: '1.1.0',
         }, {
             capabilities: {
                 tools: {},

package/package.json

@@ -2,7 +2,7 @@
   "type": "module",
   "name": "@withinfocus/tba-mcp-server",
   "mcpName": "io.github.withinfocus/tba",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "The Blue Alliance MCP Server",
   "repository": {
     "type": "git",