Diffbot MCP 服务器

一个 Diffbot MCP 服务器，为您的智能体或 LLM 流水线提供多种有用的网络数据处理工具。

什么是 Diffbot？ Diffbot 是一家小型研究公司，致力于构建能够结构化网络的 AI。我们的产品自动将应用程序连接到结构化网络，就像所有公共网络的 API 一样。

工具

🧬 extract（提取）

网页抓取工具的替代方案。 传统的抓取工具要么返回超过 50 万 token 的 HTML，要么返回页面内容的 Markdown 近似版本。Extract 会对抓取的页面进行分类，并将内容提取为有意义且一致的 JSON 结构。响应经过优化，在保持数据保真度的同时最小化 token 使用量。由 Diffbot Extract API 提供支持。

🔎 search_web（搜索网络）

一种按准确性而非流行度排名的网络搜索工具。 基于 Diffbot 的第一方网络索引构建。排名模型强烈偏向于主要来源而非次要来源（例如，新闻稿 > 关于该新闻稿的新闻报道）。返回 Markdown 格式的内容块以供来源引用。内置优化的 token 管理。

🪄 enhance（增强）

用于组织和人物的网络查询工具。 与网络搜索不同，enhance 会从 Diffbot 知识图谱返回关于组织或人物的结构化数据（通过名称、URL 或其他可接受的输入）。有助于验证事实、市场研究或销售情报工作流程。

🧠 resolve_entities（解析实体）

识别并解析文本中的实体。 使用 Diffbot NLP 识别文本中的组织、人物、地点、地址和其他专有名词。实体被解析为 Diffbot 知识图谱中的实体 ID，可以通过 dql 检索更多上下文。控制幻觉，并为 AI 提供进行深度研究所需的上下文。

🕷️ crawl（爬取）

查找网页（种子）上的所有链接并全部提取。 经典的网络爬取，附带本体论网络提取的额外功能。使用 crawl 来归档文档、拍摄网络项目的快照或进行站点地图绘制。

🎯 dql（查询）

查询 Diffbot 知识图谱中的组织、人物、文章、地点和产品实体。 Diffbot 知识图谱包含一个维基百科规模的链接图数据库，涵盖组织、人物、（新闻）文章、地点和产品。Diffbot MCP 将您的提示转换为结构化查询（dql），并返回结构化记录以供后续分析。

🧭 dql_ontology（本体）

用于精确 dql 本体导航的辅助工具。 掌握 Diffbot 整个本体和分类参考的关键。Diffbot MCP 使用它来构建准确的 dql 查询。人类无需触碰，但可以随意满足您的好奇心。

Related MCP server: AgentWebSearch-MCP

身份验证

使用工具需要免费的 Diffbot token。在此获取。

开始使用

快速开始

最简单的入门方法是直接将您的 MCP 客户端连接到 Diffbot 托管的远程 MCP 服务器。

https://mcp.diffbot.com/mcp?token=<YOUR_DIFFBOT_TOKEN>

此仓库直接部署到远程服务器。

本地安装

克隆仓库

git clone git@github.com:diffbot/diffbot-mcp.git

安装依赖

pip install .

现在您可以使用 python3 diffbot_mcp_server.py 运行服务器，如果您将通过 MCP 客户端设置此服务器，则可以跳过此步骤。

（可选）Docker 安装

构建镜像

docker build -t diffbot-mcp .

使用 MCP 客户端进行设置

要设置 Claude Desktop，请遵循官方安装指南并使用此示例 claude_desktop_config.json 配置（根据需要替换变量）。

此标准配置适用于大多数 IDE 和环境。

{
    "mcpServers": {
        "diffbot-mcp": {
            "command": "python3",
            "args": [
                "/<YOUR_PROJECT_FOLDER>/diffbot-mcp/diffbot_mcp_server.py"
            ],
            "env": {
                "DIFFBOT_TOKEN": "<YOUR_DIFFBOT_TOKEN>"
            }
        }
    }
}

对于 Docker 安装，请遵循此配置。

{
    "mcpServers": {
        "diffbot-mcp": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e", "DIFFBOT_TOKEN=<YOUR_DIFFBOT_TOKEN>",
                "diffbot-mcp"
            ]
        }
    }
}

对于远程设置，只需输入远程服务器 URL 并将传输类型设置为 "http"。

{
  "servers": {
    "diffbot-mcp": {
      "type": "http",
      "url": "https://mcp.diffbot.com/mcp/?token=<YOUR_DIFFBOT_TOKEN>"
    }
  }
}

对于本地设置，请尝试此修改后的配置以获得更好的密钥管理。

{
	"servers": {
        "diffbot-mcp": {
            "command": "python3",
            "args": [
                "/<YOUR_PROJECT_FOLDER>/diffbot-mcp/diffbot_mcp_server.py"
            ],
            "env": {
                "DIFFBOT_TOKEN": "${input:diffbot-api-key}"
            }
        }
	},
	"inputs": [
		{
			"password": true,
			"id": "diffbot-api-key",
			"type": "promptString",
			"description": "Diffbot API Key"
		}
	]
}

帮助与支持

该项目由 @jeromechoo 构建和维护。如需支持，请提交 issue，他会尽快回复您。如需更快回复，请发送邮件至 sales@diffbot.com 😜。