tagny-mcp-server 0.1.0

An MCP server with web search, URL text fetching, and more tools to enhance locally served LLMs

tagny-mcp-server

An MCP server with web search, URL text fetching, and more tools to enhance locally served LLMs.

Features

• Fetch plain text content from URLs
• Extract all links from a webpage
• Designed to work with locally served LLMs via MCP protocol

Installation

• from source

uv pip install -e .
uv pip install -e ".[dev]"

• from PyPI repository

pip install tagny-mcp-server

Usage

Start the MCP server:

• from source code:

uv run -m tagny_mcp_server

• after proper installation:
  • as described in the pyproject.toml at project.scripts, you can run the with the default arguments :

tagny-mcp-server

• customize the arguments by running like this for example:

# see the help
python -m tagny_mcp_server --help

# change the default port
python -m tagny_mcp_server --port 5002

The server will run using Server-Sent Events (SSE) transport.

Tools

fetch_url_text

Downloads and parses HTML content from a URL, returning only the visible text.

fetch_page_links

Returns a list of all hyperlinks found on a webpage.

Project Structure

• main.py - Entry point that launches the MCP server
• config.py - MCP server configuration
• web_access/ - Contains web access tools:
  • url_text_fetcher.py - Implements URL text fetching and link extraction
• pyproject.toml - Project metadata and dependencies
• scripts/client.py - Example client script for testing the server

Dependencies

• beautifulsoup4 - HTML parsing
• fastmcp - MCP server framework
• requests - HTTP requests

Testing

Tests are located in tests/ and can be run with pytest:

pytest

Example client usage is shown in scripts/client.py.