Tagny MCP Server

🚀 tagny-mcp-server

tagny-mcp-server 是一个 MCP 服务器，具备网页搜索、URL 文本提取等功能，能够增强本地部署的大语言模型（LLMs）的能力。

🚀 快速开始

启动 MCP 服务器：

• 从源代码启动：

uv run -m tagny_mcp_server

• 正确安装后：
  • 按照 pyproject.toml 文件中 project.scripts 的描述，可以使用默认参数运行：

tagny-mcp-server

• 可以通过如下方式自定义参数，例如：

# 查看帮助信息
uv run -m tagny_mcp_server --help

# 查看版本信息
uv run -m tagny_mcp_server --version

# 修改默认端口
uv run -m tagny_mcp_server --port 5002

服务器将使用 Server-Sent Events (SSE) 传输协议运行。

✨ 主要特性

• 从 URL 中提取纯文本内容
• 提取网页中的所有链接
• 设计用于通过 MCP 协议与本地部署的大语言模型（LLMs）协同工作

📦 安装指南

• 从源代码安装：

uv pip install -e .

# 安装开发依赖
uv sync

• 从 PyPI 仓库安装：

pip install tagny-mcp-server

💻 使用示例

基础用法

启动服务器的基本命令：

uv run -m tagny_mcp_server

高级用法

自定义服务器参数：

# 查看帮助
uv run -m tagny_mcp_server --help

# 查看版本
uv run -m tagny_mcp_server --version

# 更改默认端口
uv run -m tagny_mcp_server --port 5002

📚 详细文档

工具介绍

fetch_url_text

从 URL 下载并解析 HTML 内容，仅返回可见文本。

fetch_page_links

返回网页上找到的所有超链接列表。

search_web_with_brave

一个使用 Brave 搜索引擎进行网页搜索的 MCP 工具。

search_web_with_duckduckgo

一个使用 DuckDuckGo 进行网页搜索的 MCP 工具。

项目结构

• src/tagny_mcp_server/__init__.py - 主包初始化文件，导出版本信息
• src/tagny_mcp_server/__main__.py - 入口点，通过命令行参数启动 MCP 服务器
• src/tagny_mcp_server/__version__.py - 包含包版本字符串
• src/tagny_mcp_server/config.py - 配置 FastMCP 服务器实例，包含名称、说明和版本
• src/tagny_mcp_server/web_access/__init__.py - 网页访问工具的包初始化文件，导出 URL 文本提取函数
• src/tagny_mcp_server/web_access/url_text_fetcher.py - 实现从网页提取 URL 文本和链接的工具
• src/tagny_mcp_server/web_access/web_search.py - 实现 Brave 和 DuckDuckGo 搜索工具
• pyproject.toml - 项目元数据、依赖项和构建配置
• tests/scripts/client.py - 测试服务器的示例客户端脚本
• tests/test_web_access_tools.py - 网页访问工具的测试文件
• .gitignore - Git 忽略规则
• README.md - 项目文档
• LICENSE - 许可证信息
• CHANGELOG.md - 发布说明和版本历史
• CONTRIBUTING.md - 项目贡献指南
• .pre-commit-config.yaml - 预提交钩子配置
• .python-version - Python 版本规范
• .bumpversion.toml - 版本升级工具配置
• .github/ - GitHub 工作流和问题模板文件

依赖项

测试

测试文件位于 tests/ 目录下，可以使用 pytest 运行：

pytest

示例客户端用法见 scripts/client.py。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

贡献

欢迎贡献代码！请阅读 CONTRIBUTING.md 文件，了解我们的行为准则和提交拉取请求的流程。

变更日志

有关本项目的变更历史，请参阅 CHANGELOG.md。

代码质量

本项目使用预提交钩子来维护代码质量。可以通过以下命令安装：

pre-commit install

使用的工具包括：

• black（代码格式化）
• flake8（代码检查）
• isort（导入排序）
• detect-secrets（密钥检测）
• ruff（代码检查和修复） 更多信息请参阅 .pre-commit-config.yaml。

CI/CD

本项目使用 GitHub Actions 进行持续集成和部署：

• 构建工作流 - 运行测试和代码质量检查
• 发布到 Docker Hub - 在发布时发布 Docker 镜像
• 发布到 PyPI - 在发布时发布到 PyPI 更多信息请参阅 .github/workflows。

使用 Docker 运行

可以使用提供的 Dockerfile 构建和运行 Docker 容器。要在本地进行测试，可以按照 https://nektos.github.io/act/ 的说明使用 act。

# 构建 Docker 镜像
docker build -t tagny-mcp-server .

# 运行 Docker 容器
docker run -p 8000:8000 tagny-mcp-server

这将在 Docker 容器中启动 MCP 服务器，可以通过 http://localhost:8000/sse 访问。 可以将其集成到 mcp.json 文件中，如下所示：

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