# DataEyes MCP 服务

[![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)

本项目由[数眼智能](https://shuyanai.com)提供支持，是一个 MCP 服务，提供网页搜索和网页内容读取能力，用于增强 AI Agent。

## 工具

- **search** — 搜索互联网并返回结构化结果。
- **read** — 读取网页并提取正文内容。

## 获取 API Key

前往 [shuyanai.com](https://shuyanai.com)（中国站）或 [dataeyes.ai](https://dataeyes.ai)（国际站）注册获取 API Key。

## 使用方式

### stdio

适用于本地 MCP 客户端（Cursor、Claude Desktop 等），通过 [uvx](https://docs.astral.sh/uv/guides/tools/) 运行：

#### 国际站

```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"
      }
    }
  }
}
```

| 环境变量 | 默认值 | 说明 |
|---------|-------|------|
| `DATAEYES_API_KEY` | — | API Key（必填） |
| `DATAEYES_API_BASE_URL` | `https://api.dataeyes.ai` | API 地址 |

### Streamable HTTP

无需安装，直接连接托管的 MCP 端点：

#### 国际站

```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"
      }
    }
  }
}
```

## 许可证

本项目基于 [MIT 许可证](LICENSE) 发布。
