Tavily MCP Server Pg0

🚀 Tavily MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいており、Tavily API を利用して、AIによる検索機能を提供します。これにより、AIアシスタントは網羅的なウェブ検索を実行し、関連性の高い最新情報を取得することができます。

✨ 主な機能

• AIによる検索機能
• 基本的および高度な検索深度をサポート
• タイトル、URL、コンテンツの断片を含む充実した検索結果
• AIによって生成された検索結果の要約
• 結果の評価と応答時間の追跡
• 包括的な履歴記録の保存とキャッシュ
• MCPリソースによる柔軟なデータアクセス

📦 インストール

前提条件

• Node.js（v16以上）
• npm（Nodeパッケージマネージャー）
• Tavily APIキー（Tavilyウェブサイトで取得）
• 任意のMCPクライアント（例：Cline、Claude Desktop、またはその他のカスタム実装）

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/it-beard/tavily-server.git
cd tavily-mcp-server

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

📚 ドキュメント

プロジェクト構造

tavily-server/
├── src/
│   └── index.ts    # メインサーバー実装ファイル
├── data/           # 永続化ストレージディレクトリ
│   └── searches.json  # 検索履歴とキャッシュの保存場所
├── build/          # コンパイルされたJavaScriptファイルの出力先
├── package.json    # プロジェクトの依存関係とスクリプトの設定
└── tsconfig.json   # TypeScriptのコンパイル設定

サーバーの起動

npm run start

リソースアクセス

検索結果インターフェース

interface SearchResults {
  results: Array<{
    title: string;
    url: string;
    content: string;
    relevance: number;
  }>;
  total: number;
  took: number;
}

永続化ストレージ

保存場所

• データはdataディレクトリに保存されます。
• data/searches.jsonにはすべての検索履歴が含まれています。
• データはサーバーを再起動しても保持されます。
• 保存形式はJSONで、デバッグや確認が容易です。
• 保存操作中のエラーは自動的に処理されます。
• 必要なディレクトリ構造は自動的に作成されます。

開発情報

利用可能なスクリプトコマンド

• npm run build: TypeScriptコードをコンパイルして実行可能ファイルを生成します。
• npm run start: MCPサーバーを起動します（事前にコンパイルする必要があります）。
• npm run dev: 開発モードでサーバーを実行します。

エラー処理

このサーバーは、一般的な問題の診断に役立つ詳細なエラー情報を提供します。

• 無効なAPIキー
• ネットワーク接続異常
• 検索パラメーターのエラー
• APIレート制限
• リソースが見つからない
• 無効なリソースURI
• ストレージの読み書きエラー

貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します（例：git checkout -b feature/amazing-feature）。
3. 変更をコミットします（例：git commit -m '添加出色功能'）。
4. リモートブランチにプッシュします（例：git push origin feature/amazing-feature）。
5. Pull Requestを提出します。

📄 ライセンス

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

謝辞

以下のプロジェクトと技術のサポートに感謝します。

• Model Context Protocol (MCP)はサーバーフレームワークの基礎を提供しています。
• Tavily APIは検索機能の技術的なサポートを提供しています。