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，并附带两个 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/"
               ]
           }
       }
   }
   

官方版本用法

如果要在智能 Agent 应用中调用 fdp-mcp-server 工具，可以在客户端配置远程 MCP 服务 URL，并添加所需的 HTTP 标头 fdp-access 和 fdp-secret。

1. 编写 Agent 代码时，调用 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"
               ],
           }
       }
   }