iflow-mcp_mitmproxy-mcp 0.1.0__tar.gz

iflow_mcp_mitmproxy_mcp-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# mitmdumps
+
+dumps
+
+playground*

iflow_mcp_mitmproxy_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

iflow_mcp_mitmproxy_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_mitmproxy-mcp
+Version: 0.1.0
+Summary: A MCP server project
+Author-email: Lucas Soeth <lucasoeth@gmail.com>
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.3.0
+Requires-Dist: mitmproxy>=11.0.2
+Description-Content-Type: text/markdown
+
+# mitmproxy-mcp MCP server
+
+A MCP server project
+
+## Components
+
+### Resources
+
+The server implements a simple note storage system with:
+- Custom note:// URI scheme for accessing individual notes
+- Each note resource has a name, description and text/plain mimetype
+
+### Prompts
+
+The server provides a single prompt:
+- summarize-notes: Creates summaries of all stored notes
+  - Optional "style" argument to control detail level (brief/detailed)
+  - Generates prompt combining all current notes with style preference
+
+### Tools
+
+The server implements one tool:
+- add-note: Adds a new note to the server
+  - Takes "name" and "content" as required string arguments
+  - Updates server state and notifies clients of resource changes
+
+## Configuration
+
+[TODO: Add configuration details specific to your implementation]
+
+## Quickstart
+
+### Install
+
+#### Claude Desktop
+
+On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+
+<details>
+  <summary>Development/Unpublished Servers Configuration</summary>
+  ```
+  "mcpServers": {
+    "mitmproxy-mcp": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/Users/lucas/Coding/mitmproxy-mcp",
+        "run",
+        "mitmproxy-mcp"
+      ]
+    }
+  }
+  ```
+</details>
+
+<details>
+  <summary>Published Servers Configuration</summary>
+  ```
+  "mcpServers": {
+    "mitmproxy-mcp": {
+      "command": "uvx",
+      "args": [
+        "mitmproxy-mcp"
+      ]
+    }
+  }
+  ```
+</details>
+
+## Development
+
+### Building and Publishing
+
+To prepare the package for distribution:
+
+1. Sync dependencies and update lockfile:
+```bash
+uv sync
+```
+
+2. Build package distributions:
+```bash
+uv build
+```
+
+This will create source and wheel distributions in the `dist/` directory.
+
+3. Publish to PyPI:
+```bash
+uv publish
+```
+
+Note: You'll need to set PyPI credentials via environment variables or command flags:
+- Token: `--token` or `UV_PUBLISH_TOKEN`
+- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`
+
+### Debugging
+
+Since MCP servers run over stdio, debugging can be challenging. For the best debugging
+experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
+
+
+You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory /Users/lucas/Coding/mitmproxy-mcp run mitmproxy-mcp
+```
+
+
+Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

iflow_mcp_mitmproxy_mcp-0.1.0/README.md

@@ -0,0 +1,111 @@
+# mitmproxy-mcp MCP server
+
+A MCP server project
+
+## Components
+
+### Resources
+
+The server implements a simple note storage system with:
+- Custom note:// URI scheme for accessing individual notes
+- Each note resource has a name, description and text/plain mimetype
+
+### Prompts
+
+The server provides a single prompt:
+- summarize-notes: Creates summaries of all stored notes
+  - Optional "style" argument to control detail level (brief/detailed)
+  - Generates prompt combining all current notes with style preference
+
+### Tools
+
+The server implements one tool:
+- add-note: Adds a new note to the server
+  - Takes "name" and "content" as required string arguments
+  - Updates server state and notifies clients of resource changes
+
+## Configuration
+
+[TODO: Add configuration details specific to your implementation]
+
+## Quickstart
+
+### Install
+
+#### Claude Desktop
+
+On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+
+<details>
+  <summary>Development/Unpublished Servers Configuration</summary>
+  ```
+  "mcpServers": {
+    "mitmproxy-mcp": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/Users/lucas/Coding/mitmproxy-mcp",
+        "run",
+        "mitmproxy-mcp"
+      ]
+    }
+  }
+  ```
+</details>
+
+<details>
+  <summary>Published Servers Configuration</summary>
+  ```
+  "mcpServers": {
+    "mitmproxy-mcp": {
+      "command": "uvx",
+      "args": [
+        "mitmproxy-mcp"
+      ]
+    }
+  }
+  ```
+</details>
+
+## Development
+
+### Building and Publishing
+
+To prepare the package for distribution:
+
+1. Sync dependencies and update lockfile:
+```bash
+uv sync
+```
+
+2. Build package distributions:
+```bash
+uv build
+```
+
+This will create source and wheel distributions in the `dist/` directory.
+
+3. Publish to PyPI:
+```bash
+uv publish
+```
+
+Note: You'll need to set PyPI credentials via environment variables or command flags:
+- Token: `--token` or `UV_PUBLISH_TOKEN`
+- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`
+
+### Debugging
+
+Since MCP servers run over stdio, debugging can be challenging. For the best debugging
+experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
+
+
+You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory /Users/lucas/Coding/mitmproxy-mcp run mitmproxy-mcp
+```
+
+
+Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

iflow_mcp_mitmproxy_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "iflow-mcp_mitmproxy-mcp"
+version = "0.1.0"
+description = "A MCP server project"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+ "mcp>=1.3.0",
+ "mitmproxy>=11.0.2",
+]
+[[project.authors]]
+name = "Lucas Soeth"
+email = "lucasoeth@gmail.com"
+
+[build-system]
+requires = [ "hatchling",]
+build-backend = "hatchling.build"
+
+[project.scripts]
+mitmproxy-mcp = "mitmproxy_mcp:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mitmproxy_mcp"]

iflow_mcp_mitmproxy_mcp-0.1.0/src/mitmproxy_mcp/__init__.py

@@ -0,0 +1,9 @@
+from . import server
+import asyncio
+
+def main():
+    """Main entry point for the package."""
+    asyncio.run(server.main())
+
+# Optionally expose other important items at package level
+__all__ = ['main', 'server']

iflow_mcp_mitmproxy_mcp-0.1.0/src/mitmproxy_mcp/__main__.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+
+from . import main
+
+if __name__ == "__main__":
+    main()

iflow_mcp_mitmproxy_mcp-0.1.0/src/mitmproxy_mcp/flow_utils.py

@@ -0,0 +1,41 @@
+import os
+import json
+from typing import Any, Dict, List, Union
+from mitmproxy import io
+
+# Directory where mitmproxy dump files are stored
+DUMP_DIR = "/Users/lucas/Coding/mitmproxy-mcp/dumps"
+
+# Cache for storing flows per session
+FLOW_CACHE = {}
+
+async def get_flows_from_dump(session_id: str) -> list:
+    """
+    Retrieves flows from the dump file, using the cache if available.
+    """
+    dump_file = os.path.join(DUMP_DIR, f"{session_id}.dump")
+    if not os.path.exists(dump_file):
+        raise FileNotFoundError("Session not found")
+
+    if session_id in FLOW_CACHE:
+        return FLOW_CACHE[session_id]
+    else:
+        with open(dump_file, "rb") as f:
+            reader = io.FlowReader(f)
+            flows = list(reader.stream())
+        FLOW_CACHE[session_id] = flows
+        return flows
+
+def parse_json_content(content: bytes, headers: dict) -> Union[Dict, str, bytes]:
+    """
+    Attempts to parse content as JSON if the content type indicates JSON.
+    Returns the parsed JSON or the raw content if parsing fails.
+    """
+    content_type = headers.get("Content-Type", "").lower() if headers else ""
+    
+    if "application/json" in content_type or "text/json" in content_type:
+        try:
+            return json.loads(content.decode(errors="ignore"))
+        except json.JSONDecodeError:
+            return content.decode(errors="ignore")
+    return content.decode(errors="ignore")

iflow_mcp_mitmproxy_mcp-0.1.0/src/mitmproxy_mcp/json_utils.py

@@ -0,0 +1,100 @@
+from typing import Any, Dict, List, Union
+
+def generate_json_structure(json_data: Any, max_depth: int = 2, current_depth: int = 0) -> Any:
+    """
+    Generate a simplified structure of JSON content, showing keys and types
+    but replacing actual values with type indicators after a certain depth.
+    """
+    if current_depth >= max_depth:
+        if isinstance(json_data, dict):
+            return {"...": f"{len(json_data)} keys"}
+        elif isinstance(json_data, list):
+            return f"[{len(json_data)} items]"
+        else:
+            return f"({type(json_data).__name__})"
+    
+    if isinstance(json_data, dict):
+        result = {}
+        for key, value in json_data.items():
+            result[key] = generate_json_structure(value, max_depth, current_depth + 1)
+        return result
+    elif isinstance(json_data, list):
+        if not json_data:
+            return []
+        # For lists, show structure of first item and count
+        sample = generate_json_structure(json_data[0], max_depth, current_depth + 1)
+        return [sample, f"... ({len(json_data)-1} more items)"] if len(json_data) > 1 else [sample]
+    else:
+        return f"({type(json_data).__name__})"
+
+def extract_with_jsonpath(json_data: Any, path: str) -> Any:
+    """
+    Basic implementation of JSONPath extraction.
+    Supports simple dot notation and array indexing.
+    For more complex cases, consider using a full JSONPath library.
+    """
+    # Handle root object reference
+    if path == "$":
+        return json_data
+    
+    # Strip leading $ if present
+    if path.startswith("$"):
+        path = path[1:]
+    if path.startswith("."):
+        path = path[1:]
+        
+    parts = []
+    # Parse the path - handle both dot notation and brackets
+    current = ""
+    in_brackets = False
+    for char in path:
+        if char == "[":
+            if current:
+                parts.append(current)
+                current = ""
+            in_brackets = True
+        elif char == "]":
+            if in_brackets:
+                try:
+                    # Handle array index
+                    parts.append(int(current.strip()))
+                except ValueError:
+                    # Handle quoted key
+                    quoted = current.strip()
+                    if (quoted.startswith("'") and quoted.endswith("'")) or \
+                       (quoted.startswith('"') and quoted.endswith('"')):
+                        parts.append(quoted[1:-1])
+                    else:
+                        parts.append(quoted)
+                current = ""
+                in_brackets = False
+        elif char == "." and not in_brackets:
+            if current:
+                parts.append(current)
+                current = ""
+        else:
+            current += char
+    
+    if current:
+        parts.append(current)
+    
+    # Navigate through the data
+    result = json_data
+    for part in parts:
+        try:
+            if isinstance(result, dict):
+                result = result.get(part)
+            elif isinstance(result, list) and isinstance(part, int):
+                if 0 <= part < len(result):
+                    result = result[part]
+                else:
+                    return None
+            else:
+                return None
+            
+            if result is None:
+                break
+        except Exception:
+            return None
+    
+    return result