# MCP Server with URLhaus Security Checker

This is an MCP (Model Context Protocol) server that provides URL security checking using the URLhaus malware database.

## Features

- **URLhaus Security Checker**: Check URLs against the URLhaus malware database
- **MCP Server**: Compatible with MCP clients like Claude Desktop

## Customizing your MCP Server

To add your own [tools](https://developers.cloudflare.com/agents/model-context-protocol/tools/) to the MCP server, define each tool inside the `init()` method of `src/index.ts` using `this.server.tool(...)`. 

### URLhaus API Configuration

To use the URLhaus API tool:

1. Get an API key from [URLhaus](https://urlhaus.abuse.ch/api/)
2. Update the API key directly in `src/config.ts`:
   ```typescript
   export const config = {
       urlhaus: {
           apiUrl: 'https://urlhaus-api.abuse.ch/v1/url/',
           apiKey: 'your-actual-api-key-here'
       }
   };
   ```

### Available Tools

- **check_url**: Check a URL against the URLhaus malware database

## Connect Claude Desktop to your MCP server

You can connect to your MCP server from Claude Desktop using the [mcp-remote proxy](https://www.npmjs.com/package/mcp-remote). 

To connect to your MCP server from Claude Desktop, follow [Anthropic's Quickstart](https://modelcontextprotocol.io/quickstart/user) and within Claude Desktop go to Settings > Developer > Edit Config.

Update with this configuration:

```json
{
  "mcpServers": {
    "urlhaus-security": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}
```

Restart Claude and you should see the tools become available.