Mitmproxy MCP server

This MCP server implements a note-taking system that integrates with the Model Context Protocol. It provides functionality to store, manage, and summarize notes while connecting with AI systems like Claude through the MCP interface.

Installation

Installing Using a Package Manager

The MCP server can be installed using UV package manager:

uvx install mitmproxy-mcp

Setting Up with Claude Desktop

To configure the server with Claude Desktop, you'll need to modify the configuration file based on your operating system:

Configuration File Locations

• MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration Options

For a published version of the server, add this to your configuration file:

"mcpServers": {
  "mitmproxy-mcp": {
    "command": "uvx",
    "args": [
      "mitmproxy-mcp"
    ]
  }
}

For development or unpublished versions, use this configuration instead:

"mcpServers": {
  "mitmproxy-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/your/mitmproxy-mcp",
      "run",
      "mitmproxy-mcp"
    ]
  }
}

Usage Guide

Working with Notes

The server implements a note storage system with the following features:

• Uses a custom note:// URI scheme for accessing individual notes
• Each note contains a name, description, and has a text/plain mimetype

Using Available Tools

Adding Notes

You can add new notes using the add-note tool:

Tool: add-note
Arguments:
  - name: "Meeting Notes"
  - content: "Discussed project timeline and key deliverables."

This tool requires two string arguments:

• name: The title of your note
• content: The text content of your note

When executed, the server will create the new note and notify connected clients of the resource change.

Using Prompts

Summarizing Notes

The server provides a summarize-notes prompt to create summaries of all stored notes:

Prompt: summarize-notes
Arguments:
  - style: "detailed"

The style argument is optional and accepts:

• brief: For short, concise summaries
• detailed: For more comprehensive summaries

When executed, this prompt generates a new prompt combining all current notes with your style preference.

Debugging

For debugging purposes, you can use the MCP Inspector tool:

npx @modelcontextprotocol/inspector uv --directory /path/to/mitmproxy-mcp run mitmproxy-mcp

This will display a URL that you can access in your browser to inspect and debug MCP communications.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.