README.md•2.26 kB
# Remote MCP Server: User Timezone Tool
This Cloudflare Worker deploys a remote MCP server (authless) with a single tool: it returns the user's timezone based on their IP address when called from a remote MCP client.
## How it Works
- Implements an MCP-compliant server using the [`agents`](https://www.npmjs.com/package/agents) and [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk) packages.
- Defines a single "get_timezone" tool: when invoked from an MCP client (e.g. [Claude Desktop](https://modelcontextprotocol.io/quickstart/user), or [AI Playground](https://playground.ai.cloudflare.com)), it attempts to infer the timezone of the user based on their IP address (from Cloudflare headers or forwarded headers).
## Fast Deploy
[](https://deploy.workers.cloudflare.com/?url=https://github.com/your-repo-here)
This will deploy your MCP server to a URL like: `user-timezone-mcp-server.<your-account>.workers.dev/sse`
## Usage (MCP Tool)
- Tool name: `get_timezone`
- No parameters required
- Returns the user's timezone as a text message
## Local Testing (Curl Example)
Try the health endpoint directly:
```bash
curl "https://user-timezone-mcp-server.<your-account>.workers.dev/timezone"
```
Response:
```json
{"timezone":"America/Los_Angeles","ip":"203.0.113.99"}
```
Where available, the endpoint will return your timezone and detected IP address. In development or local wrangler, IP-based detection may not function.
## Connect Using Claude Desktop or Playground
- Claude Desktop: Use the [mcp-remote](https://www.npmjs.com/package/mcp-remote) proxy, set your config for `/sse` endpoint.
- Playground: Add your `/sse` endpoint in the UI, click `get_timezone`.
## Security/Privacy Considerations
- Only the user's apparent public IP address (via standard headers) is used for time zone lookup.
- No data is retained or logged except for error logging (for diagnostics only).
- No authentication is enabled—this is a public MCP endpoint intended for experimentation and utility functions.
## Customize Tools
To add more tools or behaviors, edit the `init()` method of `src/index.ts` and register additional MCP tools to `this.server`.