tagny-mcp-server

tagny/tagny-mcp-server

3.2

If you are the rightful owner of tagny-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is designed to enhance the capabilities of locally served Language Learning Models (LLMs) by integrating web search, URL text fetching, and other advanced features.

tagny-mcp-server

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

GitHub Actions Workflow PyPI Version Code Quality Contributors

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 .

# with dev dependencies
uv sync
  • 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
uv run -m tagny_mcp_server --help

# see the version
uv run -m tagny_mcp_server --version

# change the default port
uv run -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.

search_web_with_brave

An MCP tool that performs web searches using Brave search engine

search_web_with_duckduckgo

An MCP tool that performs web searches using DuckDuckGo

Project Structure

  • src/tagny_mcp_server/__init__.py - Main package initializer that exports the version
  • src/tagny_mcp_server/__main__.py - Entry point that launches the MCP server with command-line arguments
  • src/tagny_mcp_server/__version__.py - Contains the package version string
  • src/tagny_mcp_server/config.py - Configures the FastMCP server instance with name, instructions, and version
  • src/tagny_mcp_server/web_access/__init__.py - Package initializer for web access tools that exports URL text fetching functions
  • src/tagny_mcp_server/web_access/url_text_fetcher.py - Implements tools for fetching URL text and extracting links from web pages
  • src/tagny_mcp_server/web_access/web_search.py - Implements Brave and DuckDuckGo search tools
  • pyproject.toml - Project metadata, dependencies, and build configuration
  • tests/scripts/client.py - Example client script for testing the server
  • tests/test_web_access_tools.py - Tests for the web access tools
  • .gitignore - Git ignore rules
  • README.md - Project documentation
  • LICENSE - License information
  • CHANGELOG.md - Release notes and version history
  • CONTRIBUTING.md - Guidelines for contributing to the project
  • .pre-commit-config.yaml - Pre-commit hooks configuration
  • .python-version - Python version specification
  • .bumpversion.toml - Configuration for version bumping tool
  • .github/ - GitHub workflow and issue template files

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.

License

This project is licensed under the MIT License - see the file for details.

Contributing

Contributions are welcome! Please read the file for details on our code of conduct and the process for submitting pull requests.

Changelog

See for a history of changes to this project.

Code Quality

This project uses pre-commit hooks to maintain code quality. Install them with:

pre-commit install

The following tools are used:

  • black (code formatting)
  • flake8 (linting)
  • isort (import sorting)
  • detect-secrets (secret detection)
  • ruff (linting and fixing)

For more information, see .

CI/CD

This project uses GitHub Actions for continuous integration and deployment:

  • - runs tests and code quality checks
  • - publishes the Docker image on release
  • - publishes to PyPI on release

For more information, see .

Running with Docker

You can build and run the Docker container using the provided Dockerfile. To test locally, you can use act following the instructions at https://nektos.github.io/act/.

# Build the Docker image
docker build -t tagny-mcp-server .

# Run the Docker container
docker run -p 8000:8000 tagny-mcp-server

This will start the MCP server inside a Docker container, accessible at http://localhost:8000/sse.

That you can integrate in a mcp.json file like this:

{
  "mcpServers": {
    "tagny-mcp-server": {
      "url": "http://localhost:8000/sse"
    }
  }
}