Tagny MCP Server

🚀 tagny-mcp-server

Web検索、URLテキスト取得などの機能を備えたMCPサーバーで、ローカルで提供される大規模言語モデル（LLM）を強化します。

✨ 主な機能

• URLからプレーンテキストコンテンツを取得します。
• ウェブページからすべてのリンクを抽出します。
• MCPプロトコルを介してローカルで提供されるLLMと連携するように設計されています。

📦 インストール

• ソースコードからインストールする場合

uv pip install -e .

# 開発用依存関係を含める場合
uv sync

• PyPIリポジトリからインストールする場合

pip install tagny-mcp-server

💻 使用例

基本的な使用法

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) トランスポートを使用して実行されます。

高度な使用法

サーバーをDockerコンテナで実行することもできます。

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

📚 ドキュメント

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 - コード品質を維持するためのpre-commitフックの構成ファイル
• .python-version - Pythonのバージョン指定ファイル
• .bumpversion.toml - バージョン更新ツールの構成ファイル
• .github/ - GitHubのワークフローとイシューテンプレートファイルを含むディレクトリ

依存関係

• beautifulsoup4 - HTML解析用
• fastmcp - MCPサーバーフレームワーク
• requests - HTTPリクエスト用

テスト

テストは tests/ ディレクトリにあり、pytestを使用して実行できます。

pytest

サンプルクライアントの使用例は scripts/client.py に記載されています。

コード品質

このプロジェクトでは、コード品質を維持するためにpre-commitフックを使用しています。以下のコマンドでインストールできます。

pre-commit install

使用されているツールは以下の通りです。

• black（コードフォーマット）
• flake8（リンティング）
• isort（インポートのソート）
• detect-secrets（シークレット検出）
• ruff（リンティングと修正）

詳細については、.pre-commit-config.yaml を参照してください。

CI/CD

このプロジェクトでは、GitHub Actionsを使用して継続的インテグレーションとデプロイを行っています。

• Build workflow - テストとコード品質チェックを実行します。
• Publish to Docker Hub - リリース時にDockerイメージを公開します。
• Publish to PyPI - リリース時にPyPIに公開します。

詳細については、.github/workflows を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

貢献について

貢献は大歓迎です！コードの行動規範とプルリクエストの提出プロセスの詳細については、CONTRIBUTING.md ファイルを参照してください。

変更履歴

このプロジェクトの変更履歴については、CHANGELOG.md を参照してください。