Fdp MCP Server (Qax Xlab)

fdp-mcp-server

中文说明：README-zh_CN.md.

QiAnXin XLab提供MCP工具，用于访问基础网络安全数据。

关于XLab

XLab是QiAnXin旗下的一个研究团队，致力于大规模网络安全研究、威胁分析和归因，以及多维安全数据平台的构建。

XLab是中国最早利用大规模数据进行网络安全研究、安全应用和威胁情报生成的团队之一。它建立了该国第一个PassiveDNS系统，以及几个行业领先的基础数据系统，涵盖NetFlow、Whois、数字证书、IP和恶意软件样本。

工具类别

fdp-mcp服务器提供多种类型的工具。用户可以根据自己的需求选择特定的URL来加载相应的工具。

当前可用的工具集：

1. 网络安全基础数据查询\

网址：https://fdp.qianxin.com/mcp/v1/basic/mcp/\ 包括： - 弗林特rrset：查询特定域名和记录类型的资源记录集（RRsets） - 弗林特rdata：反向查找DNS响应rrset记录 - 谁的历史：检索域名或IP地址的注册历史 - certdb域：按域名查询证书数据 - 控制反转：搜索XLab的IOC（妥协指标）数据库

1. 域相关数据查询\

网址：https://fdp.qianxin.com/mcp/v1/domain/mcp/\ 包括： - 陪域：检索共同出现的域及其相关标签 - float_fqdn：基于PassiveDNS数据的域名流行度排名 - webdb：检索与域关联的网页内容 - 天秤座：从XLab的Libra平台访问域名分析数据

1. IP相关数据查询\

网址：https://fdp.qianxin.com/mcp/v1/ip/mcp/\ 包括： - ip_geo：查找IPv4地理位置、ASN和IP所有权

1. 样本相关数据查询\

网址：https://fdp.qianxin.com/mcp/v1/sample/mcp/\ 包括： - 沙盒：检索样本的汇总网络行为

执行方法

概述

1. 此应用程序充当代理，将远程MCP工具调用转换为基于本地Stdio的交互。因此，工具可以在本地使用，也可以通过其URL直接访问远程MCP服务器。
2. 远程MCP服务器目前仅支持 可流式传输HTTP 访问。
3. 这个工具集是 试用版 用于基本用途。在高并发性下，后端可能会限制访问频率。对于生产或高频场景，请使用官方版本。
4. 对于官方访问，请使用相应的工具URL并包含两个HTTP标头： fdp-access 和 fdp-secret.

- 如需获取证书，请联系QiAnXin XLab。

1. 以下示例基于 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桌面：

   {
       "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服务器工具，可以在客户端配置远程mcp服务器URL，并包含所需的HTTP标头 fdp-access 和 fdp-secret.

1. 编写代理代码时，在调用MCP工具时添加标头。使用烟雾剂的示例：

   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("Query the domains associated with www.example.com and assess its likely business purpose based on the associated data.")

   if __name__ == "__main__":
       main()

1. 如果使用Claude Desktop，您可以使用mcp远程库进行代理转发，并在此过程中配置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"
               ],
           }
       }
   }