Simple MCP Tool Server

A simple MCP server that provides a tool for fetching website content using SSE transport.

A simple MCP server that exposes a website fetching tool using SSE transport.

- Python 3.10 or higher (tested on Python 3.13)

# Create a virtual environment python3 -m venv venv # Activate the virtual environment source venv/bin/activate # Install the package and dependencies pip install -r requirements.txt

The MCP Python SDK documentation has been split into smaller files and organized in thedocs/directory. This structure makes it easier for AI agents to navigate and understand the SDK. The documentation covers:

- Core concepts (servers, resources, tools, etc.)
- Running MCP servers in different modes
- Examples and advanced usage
- And more!

The package provides a command-line interface (CLI) with several commands to manage the MCP server:

Start the server on the default port (7000) or specify a custom port:

# Using default port (7000) python -m mcp_simple_tool start # Using custom port python -m mcp_simple_tool start --port 8000

# Check if server is running python -m mcp_simple_tool check [--port PORT] # Stop the server python -m mcp_simple_tool stop [--port PORT] # Restart the server (stop and start) python -m mcp_simple_tool restart [--port PORT]

- Stop any existing server on the specified port
- Start a new server in the background
- Wait until the server is responsive
- Log output to server.log

-

fetch:RemoteHTTP fetcher – give an absolute URL; returns page text.

- url: The URL of the website to fetch (required)

search_docs: Semantic search across SDK documentation; returns top-k excerpts.

- query: Search phrase or question (required)
- k: Number of top matches to return (optional, default = 3)

get_content: Get thefull local filefor any match returned bysearch_docs.

For development, install additional tools:

pip install -e . pip install -r requirements.txt

# Format code make fmt # Run linters make lint # Run tests make test

The test suite has a built-in 20-second timeout for all tests to prevent hanging, especially with SSE endpoints. For individual tests, a more strict timeout can be specified using the@pytest.mark.timeout(seconds)decorator.

For the search_docs tool, you can manually build or rebuild the vector index:

# Build or rebuild the semantic search index python scripts/build_doc_index.py

The index is built automatically on first tool use if it doesn't exist.

mcp_simple_tool/ __init__.py # Package initialization __main__.py # Entry point when run as module cli.py # Command-line interface server/ # Server implementation __init__.py # Server package initialization app.py # ASGI application setup config.py # Configuration settings handlers.py # Tool implementations http.py # HTTP utilities semantic_search/ # Semantic search functionality __init__.py # Package initialization indexing.py # Build and persist vector store search.py # Load index and query helpers

This MCP server can be used with Cursor as a client. For setup:

source venv/bin/activate python -m mcp_simple_tool start # or use the restart command python -m mcp_simple_tool restart

- Configure Cursor by creating a.cursor/mcp.jsonfile:

{ "mcpServers": { "website-fetcher-sse": { "url": "http://localhost:7000/sse" } } }

- Mention the server in your prompts when using Cursor

Fetch web content in various formats like HTML, JSON, plain text, and Markdown.

Tools for reading and extracting content from the internet.

MCP server for browser automation via Vercel agent-browser CLI

Convert any URL to LLM-ready Markdown via real Chrome browsers. 3 tools: scrape, crawl, search. Free via MCP, pay-per-use via x402.

An MCP server that allows AI agents to control a web browser using the browser-use library.

Exposes Chrome browser functionality to AI assistants for automation, content analysis, and semantic search via a Chrome extension.

Control a Chrome browser through the Chrome DevTools Protocol (CDP) from MCP clients for browsing, inspection, and automation workflows.

Extracts factual claims from text using the Claimify methodology. Requires an OpenAI API key.

A server for web crawling and content extraction using the Crawl4AI library.