From 5204184f7063bebfb43be63654382941f507c163 Mon Sep 17 00:00:00 2001 From: Andrew Wessels Date: Wed, 18 Nov 2026 12:36:46 -1000 Subject: [PATCH] Add registry listing assets: logos, privacy section, llms-install, Agent Plugins files - assets/: official logomark SVG plus 512x512 and 400x400 PNG renders (rsvg-convert) - README: Glama score badge, support@diffbot.com contact, Privacy Policy section - llms-install.md: agent-oriented install steps - plugin.json + mcp.json (Agent Plugins 1.0.0) and .mcp.json copy for cursor.directory - sync_version.py and the Version check workflow now cover plugin.json and the .mcp.json copy - .mcpbignore keeps the new listing files out of the Claude Desktop bundle Co-Authored-By: Claude Sonnet 5.5 --- .github/workflows/version-check.yml | 5 +-- .mcp.json | 9 +++++ .mcpbignore | 6 ++++ README.md | 7 +++- RELEASING.md | 2 +- assets/diffbot-logo-400.png | Bin 0 -> 5343 bytes assets/diffbot-logo-512.png | Bin 0 -> 7074 bytes assets/diffbot-logomark.svg | 13 +++++++ llms-install.md | 52 ++++++++++++++++++++++++++++ mcp.json | 9 +++++ plugin.json | 15 ++++++++ scripts/sync_version.py | 26 ++++++++++++++ 12 files changed, 140 insertions(+), 4 deletions(-) create mode 100644 .mcp.json create mode 100644 assets/diffbot-logo-400.png create mode 100644 assets/diffbot-logo-512.png create mode 100644 assets/diffbot-logomark.svg create mode 100644 llms-install.md create mode 100644 mcp.json create mode 100644 plugin.json diff --git a/.github/workflows/version-check.yml b/.github/workflows/version-check.yml index 06f8d0c..6514888 100644 --- a/.github/workflows/version-check.yml +++ b/.github/workflows/version-check.yml @@ -1,7 +1,8 @@ name: Version check -# Fails when server.json, gemini-extension.json, manifest.json or diffbot_mcp/__init__.py -# disagree with the version in pyproject.toml. Read-only, no secrets. +# Fails when server.json, gemini-extension.json, manifest.json, plugin.json or +# diffbot_mcp/__init__.py disagree with the version in pyproject.toml, or when .mcp.json +# stops matching mcp.json. Read-only, no secrets. on: pull_request: push: diff --git a/.mcp.json b/.mcp.json new file mode 100644 index 0000000..1d72987 --- /dev/null +++ b/.mcp.json @@ -0,0 +1,9 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json", + "mcpServers": { + "diffbot": { + "type": "streamable-http", + "url": "https://mcp.diffbot.com/mcp" + } + } +} diff --git a/.mcpbignore b/.mcpbignore index 875bed0..56e2584 100644 --- a/.mcpbignore +++ b/.mcpbignore @@ -18,3 +18,9 @@ __pycache__/ *.pyc *.egg-info/ .pytest_cache/ + +assets/ +plugin.json +mcp.json +.mcp.json +llms-install.md diff --git a/README.md b/README.md index 1cb5d8f..e87c045 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ Web knowledge fetching tools for your agent. +[![diffbot/diffbot-mcp MCP server](https://glama.ai/mcp/servers/diffbot/diffbot-mcp/badges/score.svg)](https://glama.ai/mcp/servers/diffbot/diffbot-mcp) + [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=diffbot-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWZmYm90LmNvbS9tY3AifQ==) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Diffbot-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22diffbot-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.diffbot.com%2Fmcp%22%7D) @@ -241,4 +243,7 @@ The code lives in `diffbot_mcp/`: `api.py` (token resolution and the shared requ Releases are tag-driven: bump the version in `pyproject.toml`, run `python3 scripts/sync_version.py`, then push a `vX.Y.Z` tag — see [RELEASING.md](https://github.com/diffbot/diffbot-mcp/blob/main/RELEASING.md). ## Help & Support -This project is built and maintained by [@jeromechoo](https://github.com/jeromechoo). For support, file an issue and he'll get back to you as soon as he can. For faster answers, write to [sales@diffbot.com](mailto:sales@diffbot.com) 😜. +This project is built and maintained by [@jeromechoo](https://github.com/jeromechoo). For support, file an issue and he'll get back to you as soon as he can. For faster answers, write to [support@diffbot.com](mailto:support@diffbot.com). + +## Privacy Policy +Diffbot's privacy policy is at . The server sends your tool inputs (URLs, search text, DQL queries) to Diffbot's APIs to produce results. diff --git a/RELEASING.md b/RELEASING.md index 3534ba7..3fee471 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -2,7 +2,7 @@ `pyproject.toml` holds the only version number anyone edits. `scripts/sync_version.py` copies it into `server.json` (the top-level `version` and every `packages[]` entry with `registryType: pypi`), -`gemini-extension.json`, `manifest.json` (the Claude Desktop extension), and `diffbot_mcp/__init__.py`. CI fails a pull request whose copies drift. +`gemini-extension.json`, `manifest.json` (the Claude Desktop extension), `plugin.json` (the Agent Plugins manifest cursor.directory reads), and `diffbot_mcp/__init__.py`. It also keeps `.mcp.json` a byte copy of `mcp.json`. CI fails a pull request whose copies drift. Pushing a `vX.Y.Z` tag runs [`.github/workflows/release.yml`](.github/workflows/release.yml), which publishes to PyPI, then to the MCP Registry, then cuts a GitHub release. Nothing publishes without a diff --git a/assets/diffbot-logo-400.png b/assets/diffbot-logo-400.png new file mode 100644 index 0000000000000000000000000000000000000000..8959f5dbce1b9a669391888a16807e69d1dec579 GIT binary patch literal 5343 zcmcIoi9eKU`=7?MK`PzioG?;47_`^>%pN=u90+J=e8Z5!f)D7*3Mp&a^(=dAP=a#iOzRXTP!U z{u)Bz7*bERGMK7eVhalq-_4dA_aO(74n$5cyK&cb)D`YU#Pa)cHUEzr>&eDn5JqHp z)%b5e7WVH>!hp~H?i#j;dxc5ANPl#0T!wBV(%>F}lzt3vf zdh`!!6g}8NP{#Wa{IGs%8FER5p4>ifZp)yLfGAKBkOVK=_3Y0&Q|4VLp-N9AZV);p zDmSb%_q~MUW#Y1)cH#Xfigk)%!H;jyzNb8At#K!N4;4`k>FVQdT-0i?zDlI*J1SSQ zI)FGS5uhKie!G!ovX+xlw1OuiKq}ymNzDSsGem1zEDuM0c`z;Lz=(&S>&M~7Ro1j( zyd?9>mWsqUGbPM2DvYibtA&9#)`6TIEYpAOEIDt<`0PBK}^*=wE}_-2c;Yha{6!L&Pal4h78}sVHy2B-TED z!|w>s#5ag}UCOoFN0%v(+QIebUGD1>&

KQbB(v~2Q?QM@$T@VOG+#z3+VOe@ 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 literal 0 HcmV?d00001 diff --git a/assets/diffbot-logo-512.png b/assets/diffbot-logo-512.png new file mode 100644 index 0000000000000000000000000000000000000000..f41f68a84e2560f78f7170720465cbaf0d3b979d GIT binary patch literal 7074 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 YFS2ww>r#8k1E1Nq*JV%X*R+KH1+30)G5`Po literal 0 HcmV?d00001 diff --git a/assets/diffbot-logomark.svg b/assets/diffbot-logomark.svg new file mode 100644 index 0000000..1f59888 --- /dev/null +++ b/assets/diffbot-logomark.svg @@ -0,0 +1,13 @@ + + + + + + + + + + + + + diff --git a/llms-install.md b/llms-install.md new file mode 100644 index 0000000..ba63b2a --- /dev/null +++ b/llms-install.md @@ -0,0 +1,52 @@ +# Installing Diffbot MCP (instructions for AI agents) + +Diffbot MCP gives you web search, page extraction, site crawls, and Diffbot Knowledge Graph queries. +Pick one of the two options below. Never write a real token into a file that is committed to git. + +## Option 1: hosted server (no token to paste) + +Add a remote Streamable HTTP server. The user signs in with a Diffbot account (OAuth) the first time a tool runs. + +```json +{ + "mcpServers": { + "diffbot-mcp": { + "type": "streamable-http", + "url": "https://mcp.diffbot.com/mcp" + } + } +} +``` + +If your client cannot do OAuth, send the header `Authorization: Bearer ` instead. + +## Option 2: local server with `uvx` + +Requires [uv](https://docs.astral.sh/uv/). The server reads its token from `DIFFBOT_TOKEN`, +`DIFFBOT_API_TOKEN`, or `~/.diffbot/credentials`. + +```json +{ + "mcpServers": { + "diffbot-mcp": { + "command": "uvx", + "args": ["diffbot-mcp"], + "env": { "DIFFBOT_TOKEN": "" } + } + } +} +``` + +A free token is available at https://app.diffbot.com/get-started. Ask the user for it; do not invent one. + +## Check that it works + +List the server's tools. You should see 12: `extract`, `search_web`, `crawl`, `resolve_entities`, +`search_news`, `search_organizations`, `search_people`, `search_places`, `search_deals`, `dql`, +`dql_probe`, and `dql_ontology`. Then try `search_web` with a short query. + +## Links + +- Docs: https://www.diffbot.com/docs/interfaces/mcp-server +- Source: https://github.com/diffbot/diffbot-mcp +- Support: support@diffbot.com diff --git a/mcp.json b/mcp.json new file mode 100644 index 0000000..1d72987 --- /dev/null +++ b/mcp.json @@ -0,0 +1,9 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json", + "mcpServers": { + "diffbot": { + "type": "streamable-http", + "url": "https://mcp.diffbot.com/mcp" + } + } +} diff --git a/plugin.json b/plugin.json new file mode 100644 index 0000000..d8948d2 --- /dev/null +++ b/plugin.json @@ -0,0 +1,15 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", + "name": "diffbot", + "version": "0.2.2", + "description": "Web knowledge fetching tools for your agent: search, extract, crawl, and query the Diffbot Knowledge Graph.", + "author": { + "name": "Diffbot", + "email": "support@diffbot.com", + "url": "https://www.diffbot.com" + }, + "homepage": "https://www.diffbot.com/docs/interfaces/mcp-server", + "repository": "https://github.com/diffbot/diffbot-mcp", + "license": "MIT", + "keywords": ["web", "search", "extract", "crawl", "knowledge-graph", "research", "mcp"] +} diff --git a/scripts/sync_version.py b/scripts/sync_version.py index 22bcc56..cfb44b2 100755 --- a/scripts/sync_version.py +++ b/scripts/sync_version.py @@ -5,6 +5,7 @@ - server.json: the top-level "version" and every packages[] entry with registryType "pypi" - gemini-extension.json: "version" - manifest.json: the top-level "version" (Claude Desktop / MCPB) + - plugin.json: the top-level "version" (Agent Plugins manifest, read by cursor.directory) - diffbot_mcp/__init__.py: __version__ The JSON files are edited in place, one "version" value at a time, so hand-written @@ -38,6 +39,9 @@ SERVER_JSON = ROOT / "server.json" GEMINI_JSON = ROOT / "gemini-extension.json" MANIFEST_JSON = ROOT / "manifest.json" +PLUGIN_JSON = ROOT / "plugin.json" +MCP_JSON = ROOT / "mcp.json" +DOT_MCP_JSON = ROOT / ".mcp.json" INIT_PY = ROOT / "diffbot_mcp" / "__init__.py" # Matches one "version": "..." pair; group 2 is the value, which is what we rewrite. @@ -99,6 +103,13 @@ def manifest_slots(data: dict) -> list[Slot]: ] +def plugin_slots(data: dict) -> list[Slot]: + return [ + Slot(f"plugin.json {path.lstrip('.')}", value, path == ".version") + for path, value in walk_version_keys(data) + ] + + def stamp_json(path: Path, slots: list[Slot], version: str, write: bool) -> list[str]: """Report slots that disagree with `version`; when `write`, rewrite just those values.""" text = path.read_text(encoding="utf-8") @@ -134,6 +145,16 @@ def stamp_init(version: str, write: bool) -> list[str]: return [f"diffbot_mcp/__init__.py __version__ is {match.group(1)!r}"] +def sync_mcp_copy(write: bool) -> list[str]: + """.mcp.json (the path cursor.directory scans) must be a byte copy of mcp.json (the Agent Plugins path).""" + source = MCP_JSON.read_bytes() + if DOT_MCP_JSON.exists() and DOT_MCP_JSON.read_bytes() == source: + return [] + if write: + DOT_MCP_JSON.write_bytes(source) + return [".mcp.json differs from mcp.json"] + + def sync(version: str, write: bool) -> list[str]: server = json.loads(SERVER_JSON.read_text(encoding="utf-8")) slots, problems = server_slots(server) @@ -145,6 +166,11 @@ def sync(version: str, write: bool) -> list[str]: manifest = json.loads(MANIFEST_JSON.read_text(encoding="utf-8")) problems += stamp_json(MANIFEST_JSON, manifest_slots(manifest), version, write) + plugin = json.loads(PLUGIN_JSON.read_text(encoding="utf-8")) + problems += stamp_json(PLUGIN_JSON, plugin_slots(plugin), version, write) + + problems += sync_mcp_copy(write) + problems += stamp_init(version, write) return problems