Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

feat: add DataForSEO as an official MCP connection (#4397)

Colton Padden5139768f805c
diff --git a/apps/docs/registry.json b/apps/docs/registry.json
index 04b63d808..cbda3743b 100644
--- a/apps/docs/registry.json
+++ b/apps/docs/registry.json
@@ -492,6 +492,23 @@
}
]
},
+ {
+ "name": "connection/dataforseo",
+ "type": "registry:item",
+ "title": "DataForSEO",
+ "description": "Run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",
+ "envVars": {
+ "DATAFORSEO_USERNAME": "",
+ "DATAFORSEO_PASSWORD": ""
+ },
+ "files": [
+ {
+ "path": "registry/connections/dataforseo.ts",
+ "type": "registry:file",
+ "target": "agent/connections/dataforseo.ts"
+ }
+ ]
+ },
{
"name": "connection/vercel",
"type": "registry:item",
diff --git a/apps/docs/registry/connections/dataforseo.ts b/apps/docs/registry/connections/dataforseo.ts
new file mode 100644
index 000000000..56be1e930
--- /dev/null
+++ b/apps/docs/registry/connections/dataforseo.ts
@@ -0,0 +1,15 @@
+import { defineMcpClientConnection } from "eve/connections";
+
+export default defineMcpClientConnection({
+ url: "https://mcp.dataforseo.com/v3/mcp",
+ description:
+ "DataForSEO: run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",
+ headers: () => {
+ const login = process.env.DATAFORSEO_USERNAME!;
+ const password = process.env.DATAFORSEO_PASSWORD!;
+ const token = Buffer.from(`${login}:${password}`).toString("base64");
+ return {
+ Authorization: `Basic ${token}`,
+ };
+ },
+});
diff --git a/apps/docs/scripts/validate-connection-registry.ts b/apps/docs/scripts/validate-connection-registry.ts
index a3ed38c82..3663f1e67 100644
--- a/apps/docs/scripts/validate-connection-registry.ts
+++ b/apps/docs/scripts/validate-connection-registry.ts
@@ -43,6 +43,7 @@ const expectedSlugs = connectionEntries()
.filter((entry) => entry.surfaces.registry)
.map((entry) => entry.slug);
const actualSlugs = items.map((item) => item.name.slice("connection/".length));
+const NON_CONNECT_SLUGS = new Set(["browser-use", "dataforseo"]);
const CONNECT_SERVICES: Readonly<Record<string, string>> = {
agentcard: "mcp.agentcard.sh/mcp",
vercel: "vercel",
@@ -72,6 +73,9 @@ if (JSON.stringify(actualSlugs) !== JSON.stringify(expectedSlugs)) {
}
for (const item of items) {
+ const slug = item.name.slice("connection/".length);
+ if (NON_CONNECT_SLUGS.has(slug)) continue;
+
const declaredSetup = item.meta?.eve?.setup;
const setups =
declaredSetup === undefined
@@ -93,41 +97,38 @@ for (const item of items) {
);
}
- const slug = item.name.slice("connection/".length);
- if (slug !== "browser-use") {
- const creationType = CONNECT_CREATION_TYPES[slug];
- const connectionMethod = CONNECT_METHODS[slug];
- const principalType = CONNECT_PRINCIPAL_TYPES[slug];
- const expectedSetup =
+ const creationType = CONNECT_CREATION_TYPES[slug];
+ const connectionMethod = CONNECT_METHODS[slug];
+ const principalType = CONNECT_PRINCIPAL_TYPES[slug];
+ const expectedSetup =
+ slug === "shopify"
+ ? {
+ command: "eve",
+ package: "eve",
+ bin: "eve",
+ args: ["integration", "setup", "shopify"],
+ }
+ : {
+ command: "eve",
+ package: "eve",
+ bin: "eve",
+ args: [
+ "integration",
+ "connect",
+ slug,
+ CONNECT_SERVICES[slug] ?? slug,
+ slug,
+ ...(creationType === undefined ? [] : ["--creation-type", creationType]),
+ ...(connectionMethod === undefined ? [] : ["--connection-method", connectionMethod]),
+ ...(principalType === undefined ? [] : ["--principal-type", principalType]),
+ ],
+ };
+ if (JSON.stringify(setups) !== JSON.stringify([expectedSetup])) {
+ throw new Error(
slug === "shopify"
- ? {
- command: "eve",
- package: "eve",
- bin: "eve",
- args: ["integration", "setup", "shopify"],
- }
- : {
- command: "eve",
- package: "eve",
- bin: "eve",
- args: [
- "integration",
- "connect",
- slug,
- CONNECT_SERVICES[slug] ?? slug,
- slug,
- ...(creationType === undefined ? [] : ["--creation-type", creationType]),
- ...(connectionMethod === undefined ? [] : ["--connection-method", connectionMethod]),
- ...(principalType === undefined ? [] : ["--principal-type", principalType]),
- ],
- };
- if (JSON.stringify(setups) !== JSON.stringify([expectedSetup])) {
- throw new Error(
- slug === "shopify"
- ? 'Registry item "connection/shopify" must run eve integration setup shopify.'
- : `Registry item "${item.name}" must configure its Vercel Connect connector through eve.`,
- );
- }
+ ? 'Registry item "connection/shopify" must run eve integration setup shopify.'
+ : `Registry item "${item.name}" must configure its Vercel Connect connector through eve.`,
+ );
}
const expectedPath = `registry/connections/${slug}.ts`;
@@ -141,14 +142,6 @@ for (const item of items) {
await access(join(docsRoot, expectedPath));
switch (slug) {
- case "browser-use": {
- if (item.dependencies !== undefined || !("BROWSER_USE_API_KEY" in (item.envVars ?? {}))) {
- throw new Error(
- 'Registry item "connection/browser-use" must declare its API key without Vercel Connect.',
- );
- }
- break;
- }
case "shopify": {
if (item.dependencies !== undefined) {
throw new Error('Registry item "connection/shopify" must not declare dependencies.');
diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.ts
index f0c485ce6..7e624003f 100644
--- a/packages/eve-catalog/src/index.ts
+++ b/packages/eve-catalog/src/index.ts
@@ -391,6 +391,18 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [
mcp: { url: "https://api.browser-use.com/v3/mcp" },
},
},
+ {
+ slug: "dataforseo",
+ name: "DataForSEO",
+ kind: "connection",
+ tagline: "Run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",
+ surfaces: { scaffoldable: false, registry: true, gallery: false },
+ connection: {
+ description:
+ "DataForSEO: run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",
+ mcp: { url: "https://mcp.dataforseo.com/v3/mcp" },
+ },
+ },
{
slug: "vercel",
name: "Vercel",