# DataEyes MCP Server

[![PyPI version](https://img.shields.io/pypi/v/dataeyes-mcp-server.svg)](https://pypi.org/project/dataeyes-mcp-server/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

[中文版说明](README_zh.md)

An MCP server that provides web search and page reading capabilities through the [DataEyes](https://dataeyes.ai) API.

## Tools

- **search** — Search the web and get structured results.
- **read** — Fetch a web page and extract its content.

## Getting Your API Key

Register at [shuyanai.com](https://shuyanai.com) (中国站) or [dataeyes.ai](https://dataeyes.ai) (Global) to obtain your API key.

## Usage

### stdio

For local MCP clients (Cursor, Claude Desktop, etc.) using [uvx](https://docs.astral.sh/uv/guides/tools/):

#### Global

```json
{
  "mcpServers": {
    "dataeyes": {
      "command": "uvx",
      "args": ["dataeyes-mcp-server"],
      "env": {
        "DATAEYES_API_KEY": "your-api-key"
      }
    }
  }
}
```

#### 中国站

```json
{
  "mcpServers": {
    "dataeyes": {
      "command": "uvx",
      "args": ["dataeyes-mcp-server"],
      "env": {
        "DATAEYES_API_KEY": "your-api-key",
        "DATAEYES_API_BASE_URL": "https://api.shuyanai.com"
      }
    }
  }
}
```

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `DATAEYES_API_KEY` | — | API key (required) |
| `DATAEYES_API_BASE_URL` | `https://api.dataeyes.ai` | API base URL |

### Streamable HTTP

No installation required. Connect directly to the hosted MCP endpoint:

#### Global

```json
{
  "mcpServers": {
    "dataeyes": {
      "url": "https://mcp.dataeyes.ai/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}
```

#### 中国站

```json
{
  "mcpServers": {
    "dataeyes": {
      "url": "https://mcp.shuyanai.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}
```

## License

This project is licensed under the [MIT License](LICENSE).