dataforseo-mcp-server

The dataforseo-mcp-server is a comprehensive MCP server designed for seamless integration with the DataForSEO API. This server allows Large Language Models (LLMs) like Claude to perform SEO-related tasks such as SEO analysis, keyword research, and backlink analysis through natural language interactions. Utilizing stdio as its transport layer, it facilitates easy integration with various LLM platforms.

GitHub Stars

50

User Rating

Not Rated

Favorites

0

Views

136

Forks

20

Issues

5

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Node.js: 18.0.0以上
npm: 8.0.0以上

Installation

Installation

Prerequisites

Please specify required software and versions:
Node.js: 18.0.0 or higher
npm: 8.0.0 or higher
Claude Desktop: Latest version

Installation Steps

1. Clone Repository

bash
git clone https://github.com/Skobyn/dataforseo-mcp-server.git
cd dataforseo-mcp-server

2. Install Dependencies

bash
npm install

3. Build the Project

bash
npm run build

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Node.js version and reinstall dependencies.

Configuration

Configuration

Basic Configuration

Claude Desktop Setup

Edit ~/.config/claude-desktop/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
json
{
  "mcpServers": {
    "dataforseo-mcp": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "DATAFORSEO_LOGIN": "your_login",
        "DATAFORSEO_PASSWORD": "your_password"
      }
    }
  }
}

Environment Variables

Set the following environment variables as needed:
bash
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

Security Settings

Store API keys in environment variables or secure configuration files
Set appropriate file access permissions
Adjust logging levels

Configuration Example

json
{
  "mcpServers": {
    "dataforseo-mcp": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "PORT": "3000",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Examples

Examples

Basic Usage

Here are basic usage examples for the MCP server:

Using with Claude Desktop

1Verify MCP Server Startup
Open Claude Desktop and confirm that the configuration has been loaded correctly.
2Execute Basic Commands

   Available tools from this MCP server:
   - tool1: Description of tool1
   - tool2: Description of tool2
   

Programmatic Usage

javascript
// JavaScript example (Node.js)
const { MCPClient } = require('@modelcontextprotocol/client');

const client = new MCPClient();
await client.connect();

// Execute tool
const result = await client.callTool('toolName', {
  parameter1: 'value1',
  parameter2: 'value2'
});

console.log(result);

Advanced Examples

Automation Script

bash
#!/bin/bash

Batch processing example

for file in *.txt; do mcp-tool process "$file" done

API Integration

python

Python example

import requests import json def call_mcp_tool(tool_name, params): response = requests.post( 'http://localhost:3000/mcp/call', json={ 'tool': tool_name, 'parameters': params } ) return response.json()

Usage example

result = call_mcp_tool('analyze', { 'input': 'sample data', 'options': {'format': 'json'} })

Use Cases

Perform SEO analysis using natural language interactions.
Conduct keyword research and obtain relevant keyword suggestions.
Analyze backlink profiles and evaluate referring domains.
Conduct website audits and perform content analysis.
Utilize AI for content generation.

Additional Resources