What is Cf Mcp Server

cf-mcp-server is a Cloudflare Worker that implements the Model Context Protocol (MCP), enabling Claude to access various external services and APIs directly during conversations.

Use cases

Use cases include asking Claude for current weather updates, retrieving information about specific IP addresses, conducting web searches for specific queries, and making custom API requests.

How to use

To use cf-mcp-server, deploy it on Cloudflare following the setup instructions, then interact with Claude by asking it to perform tasks such as fetching weather data or performing web searches.

Key features

Key features include fetching weather information, IP geolocation lookups, web searches with customizable result counts, and making custom HTTP requests with full control over headers and methods.

Where to use

cf-mcp-server can be used in applications that require real-time data retrieval from external APIs, such as chatbots, virtual assistants, and customer support systems.

MCP-Enabled Cloudflare Worker for Claude

This repository contains a Cloudflare Worker implementing the Model Context Protocol (MCP), which allows Claude to access various external services and APIs directly from your conversations.

Features

The worker provides the following tools for Claude to use:

• Weather Information: Fetch current weather data for any city
• IP Geolocation: Look up detailed information about any IP address
• Web Search: Perform Google searches with customizable result count
• HTTP Request Proxy: Make custom HTTP requests to any endpoint with full control over headers, methods, and body data

Setup Instructions

Prerequisites

• Node.js and npm installed
• Cloudflare account

Installation

1. Install Wrangler CLI

  npm install -g wrangler

2. Log in to Cloudflare

  wrangler login

3. Clone this repository

  git clone https://github.com/anishgowda21/cf-mcp-server.git
  cd cf-mcp-server

4. Install dependencies

  npm install

5. Set up MCP

  npx workers-mcp setup

Configuration

You’ll need to set the following environment variables in the Cloudflare Dashboard (recommended for security) instead of in the wrangler.toml file:

• OPENWEATHERMAP_API_KEY (for weather data)
• IPINFO_API_KEY (for IP geolocation)
• GOOGLE_API_KEY (for web search)
• GOOGLE_CX (for web search)

To do this:

1. Go to the Cloudflare Dashboard
2. Navigate to Workers & Pages
3. Select your worker
4. Go to Settings > Variables
5. Add your environment variables under “Environment Variables”

Note: If you don’t need a particular service, you can simply not set its API key. The corresponding function will return an error when called, but the rest of the worker will continue to function.

Deployment

Deploy your worker to Cloudflare:

npm run deploy

Usage with Claude

Once deployed, you can use your MCP server with Claude. To do this, simply ask Claude to use your worker for various tasks:

• “Get the weather for Tokyo”
• “Look up information about IP address 8.8.8.8”
• “Search the web for ‘latest AI developments’”
• “Make a GET request to https://example.com/api/data”

Claude will automatically use the appropriate function based on your request.

Function Reference

getWeatherData(cityName: string)

Fetches current weather data for the specified city.

getIpDetails(ipAddr: string)

Retrieves detailed geolocation information for an IP address. Use “me” to get information about the client’s IP.

googleWebSearch(query: string, num?: number)

Performs a Google search with the specified query and returns the specified number of results (1-10, default: 5).

makeRequest(url: string, method: string, params?: object)

Makes a custom HTTP request with specified method, headers, and body data. The params object can include:

• headers: Record of HTTP headers
• body: Request body (string or object that will be automatically stringified)

Customization

To modify the worker or add new functions:

1. Edit src/index.ts
2. Add new methods to the MyWorker class with JSDoc comments to document the functionality
3. Deploy using npm run deploy

Troubleshooting

• If you encounter issues with API responses, check that you’ve set up the appropriate environment variables in the Cloudflare Dashboard
• If a specific function isn’t working, you might need to obtain the corresponding API key
• For functions you don’t need, you can comment out the relevant code in src/index.ts