Content
# MCP Weather & DigitalOcean
A collection of Model Context Protocol (MCP) servers for use with Cursor.
## Project Structure
```
src/
├── index.ts # Main entry point
├── shared/ # Shared utilities
│ └── api.ts # Shared API utilities
├── weather/ # Weather MCP server
│ ├── api.ts # Weather API functions
│ ├── server.ts # Weather MCP server configuration
│ └── types.ts # Weather API types
├── digitalocean/ # DigitalOcean MCP server
│ ├── api.ts # DigitalOcean API functions
│ ├── server.ts # DigitalOcean MCP server configuration
│ └── types.ts # DigitalOcean API types
└── template/ # Template for new MCP servers
├── api.ts # Template API functions
├── server.ts # Template MCP server configuration
└── types.ts # Template API types
tests/ # Test scripts and files
```
## Available MCP Servers
### Weather Server
The Weather MCP server provides tools for accessing weather information from the National Weather Service API.
#### Tools:
- **get-alerts**: Get weather alerts for a US state
- Parameters: `state` (two-letter state code, e.g., CA, NY)
- **get-forecast**: Get weather forecast for a location
- Parameters: `latitude` and `longitude` coordinates
### DigitalOcean Server
The DigitalOcean MCP server provides tools for deploying and managing static websites on DigitalOcean App Platform using their API.
#### API Token Handling
The DigitalOcean MCP server will automatically look for your API token in the following locations (in order):
1. As a parameter in the tool call
2. Environment variables: `DO_API_TOKEN` or `DIGITALOCEAN_API_TOKEN`
3. A file at `~/.dotoken` containing just the token
4. A `.env` file in the project root with `DO_API_TOKEN=your_token`
5. A file at `~/.config/digitalocean/token` containing just the token
This means you can set up your token once and not have to provide it with every command.
#### Tools:
- **deploy-static-site**: Deploy a static website to DigitalOcean App Platform
- Required Parameters:
- `app_name`: Name for your app
- `repo`: GitHub repository (username/repo)
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
- `region`: Region code (e.g., nyc, sfo) - Default: "nyc"
- `branch`: Branch to deploy - Default: "main"
- `source_dir`: Directory in repo containing source code - Default: "/"
- `build_command`: Build command (if needed)
- `output_dir`: Directory where build outputs files
- `deploy_on_push`: Auto-deploy on git push - Default: true
- `environment_slug`: Runtime environment - Default: "html"
- `custom_domain`: Custom domain (optional)
- **get-app-info**: Get information about a DigitalOcean App Platform app
- Required Parameters:
- `app_id`: App ID
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
- **get-deployment-status**: Get the status of a specific deployment
- Required Parameters:
- `app_id`: App ID
- `deployment_id`: Deployment ID
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
- **list-deployments**: List all deployments for an app
- Required Parameters:
- `app_id`: App ID
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
- **create-deployment**: Create a new deployment (redeploy an app)
- Required Parameters:
- `app_id`: App ID
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
- `force_build`: Force a rebuild without cache - Default: false
- **get-deployment-logs**: Get logs for a deployment
- Required Parameters:
- `app_id`: App ID
- `deployment_id`: Deployment ID
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
- **delete-app**: Delete an app from DigitalOcean App Platform
- Required Parameters:
- `app_id`: App ID
- Optional Parameters:
- `token`: DigitalOcean API token (optional if stored in environment or config files)
## Adding a New MCP Server
To add a new MCP server:
1. Copy the `template` directory and rename it to your server name
2. Update the types, API functions, and server configuration
3. Add your server to the main `index.ts` file
## Building and Running
```bash
# Install dependencies
npm install
# Build the project
npm run build
# Run the Weather MCP server
node build/index.js
# Run the DigitalOcean MCP server
node build/index.js digitalocean
```
## Testing
The project includes several test scripts in the `tests/` directory:
- `test-simple.mjs`: A simple test script that sends JSON-RPC requests to the MCP server
- `test-api.mjs`: A script that directly tests the DigitalOcean API
- `test-mcp.mjs`: A more comprehensive test for the MCP server
- `test-deploy.mjs`: A test script specifically for the deploy-static-site tool
- `token-test.mjs`: A utility script to verify that the DigitalOcean API token can be read correctly
To run a test:
```bash
# Run a test script
node tests/test-simple.mjs
```
## Cursor Integration
To use with Cursor, add the following to your `.cursor/mcp.json` file:
```json
{
"mcpServers": {
"weather": {
"command": "node",
"args": [
"/path/to/your/project/build/index.js"
]
},
"digitalocean": {
"command": "node",
"args": [
"/path/to/your/project/build/index.js",
"digitalocean"
]
}
}
}
```
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
markitdown
Python tool for converting files and office documents to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.
Fetch
Retrieve and process content from web pages by converting HTML into markdown format.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.