Basic Network Data Query Tool

fdp-mcp-server

中国語の説明：README-zh_CN.md。

QiAnXin XLab は、基盤となるネットワークセキュリティデータにアクセスするための MCP ツールを提供しています。

XLab について

XLab は QiAnXin 傘下の研究チームで、大規模なネットワークセキュリティ研究、脅威分析とアトリビューション、および多次元セキュリティデータプラットフォームの構築に取り組んでいます。

XLab は、中国でいち早く大規模データをサイバーセキュリティ研究、セキュリティアプリケーション、脅威インテリジェンスの生成に活用したチームの一つです。同チームは、国内初の PassiveDNS システムを構築したほか、NetFlow、Whois、デジタル証明書、IP、マルウェアサンプルを対象とする、業界をリードする複数の基盤データシステムも構築しました。

ツールのカテゴリ

fdp-mcp-server は、複数のカテゴリのツールを提供します。ユーザーはニーズに応じて特定の URL を選択し、対応するツールを読み込めます。

現在利用可能なツールセット：

1. 基本的なネットワークセキュリティデータのクエリ
   URL: https://fdp.qianxin.com/mcp/v1/basic/mcp/
   含まれるツール：
   • flint rrset：特定のドメイン名とレコードタイプのリソースレコードセット（RRset）をクエリします
   • flint rdata：DNS 応答の rrset レコードを逆引きします
   • whois history：ドメイン名または IP アドレスの登録履歴を取得します
   • certdb domain：ドメイン名から証明書データをクエリします
   • ioc：XLab の IOC（侵害指標）データベースを検索します
2. ドメイン関連データのクエリ
   URL: https://fdp.qianxin.com/mcp/v1/domain/mcp/
   含まれるツール：
   • codomain：共起するドメインと、それに関連付けられたタグを取得します
   • float_fqdn：PassiveDNS データに基づくドメインの人気ランキング
   • webdb：ドメインに関連付けられたウェブページのコンテンツを取得します
   • libra：XLab の Libra プラットフォームからドメインの分析データにアクセスします
3. IP 関連データのクエリ
   URL: https://fdp.qianxin.com/mcp/v1/ip/mcp/
   含まれるツール：
   • ip_geo：IPv4 の位置情報、ASN、IP の所有者を検索します
4. サンプル関連データのクエリ
   URL: https://fdp.qianxin.com/mcp/v1/sample/mcp/
   含まれるツール：
   • sandbox：サンプルのネットワーク動作の要約を取得します

実行方法

概要

1. このアプリケーションは、リモート MCP ツールの呼び出しをローカルの Stdio ベースのやり取りに変換するプロキシとして機能します。そのため、ツールはローカルで使用することも、URL を使ってリモート MCP サーバーに直接アクセスして使用することもできます。
2. リモート MCP サーバーは現在、streamable HTTP アクセスのみをサポートしています。
3. このツールセットは、基本的な利用を想定した試用版です。同時実行数が多い場合、バックエンドによってアクセス頻度が制限されることがあります。本番環境や高頻度の利用では、公式版をご利用ください。
4. 公式に利用する場合は、対応するツールの URL を使用し、次の2つの HTTP ヘッダーを含めてください：fdp-access と fdp-secret。
   • 認証情報を取得するには、QiAnXin XLab までお問い合わせください。
5. 以下の例は、Basic Network Security Data Query ツールに基づいています。

試用版の利用方法

ソースコードからローカルで実行する

1. リポジトリをクローンします。
2. uv を使用して実行し、Claude Desktop を設定します：

   {
       "mcpServers": {
           "fdp-mcp-server": {
               "command": "uv",
               "args": [
                   "run",
                   "--project",
                   "/PATH/TO/fdp-mcp-server",
                   "fdp-mcp-server",
                   "--url",
                   "https://fdp.qianxin.com/mcp/v1/basic/mcp/"
               ]
           }
       }
   }
   

Docker で実行する

1. リポジトリをクローンします。
2. Docker イメージをビルドします：docker build . fdp-mcp-server:vxx.xx.xx
3. Claude Desktop を設定します：

   {
       "mcpServers": {
           "fdp-mcp-server": {
               "command": "docker",
               "args": [
                   "run",
                   "-i",
                   "--rm",
                   "fdp-mcp-server:vxx.xx.xx"
               ]
           }
       }
   }
   

PyPI パッケージ経由で実行する

1. uvx を使用し、Claude Desktop を次のように設定します。

       {
       "mcpServers": {
           "fdp-mcp-server": {
               "command": "uvx",
               "args": [
                   "fdp-mcp-server",
                   "--url",
                   "https://fdp.qianxin.com/mcp/v1/basic/mcp/"
               ]
           }
       }
   }
   

公式バージョンの使用方法

インテリジェントエージェントアプリケーション内から fdp-mcp-server のツールを呼び出す場合は、クライアント側でリモート MCP サーバーの URL を設定し、必要な HTTP ヘッダー fdp-access と fdp-secret を含めます。

1. エージェントのコードを記述する際は、MCP ツールの呼び出し時にヘッダーを追加します。smolagents を使用した例：

   from smolagents import ToolCollection
   from smolagents.agents import ToolCallingAgent
   from smolagents.models import OpenAIServerModel
   
   
   def main():
       with ToolCollection.from_mcp(
           {
               "url": "https://fdp.qianxin.com/mcp/v1/domain/mcp/",
               "transport": "streamable-http",
               "headers": {
                   "fdp-access": "xxxx",
                   "fdp-secret": "yyyy",
               },
           },
           trust_remote_code=True,
       ) as tools:
           agent = ToolCallingAgent(
               tools=[*tools.tools],
               model=OpenAIServerModel(
                   model_id="YOUR-LLM-MODEL-ID",
                   api_base="YOUR-LLM-MODEL-API-URL",
                   api_key="YOUR-LLM-MODEL-API-KEY",
               ),
           )
           agent.run("www.example.com に関連するドメインを照会し、関連データに基づいて、その事業目的として考えられるものを評価してください。")
   
   
   if __name__ == "__main__":
       main()
   

2. Claude Desktop を使用する場合は、mcp-remote ライブラリを使ってプロキシ転送を行い、その際に HTTP ヘッダーを設定できます。

   {
       "mcpServers": {
           "fdp_domain": {
               "command": "npx",
               "args": [
                   "-y",
                   "mcp-remote@latest",
                   "https://fdp.qianxin.com/mcp/v1/domain/mcp/",
                   "--header",
                   "fdp-access:xxxx",
                   "--header",
                   "fdp-secret:yyyy"
               ],
           }
       }
   }