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"
    }
  }
}