Owlfy Exa MCP

Exa web search and page fetch MCP server for Owlfy.

基于 Exa API 的 MCP 服务器，提供两个工具：

• web_search_exa
• web_fetch_exa

适合在 Owlfy、Codex、Claude Desktop 或其他支持 MCP stdio 的客户端中使用。

如果宿主支持基于配置项自动注入环境变量，可以直接使用仓库内的 smithery.yaml，将 apiKey 映射到 EXA_API_KEY。

Features

| 功能 | 状态 | | --- | --- | | Exa 自然语言网页搜索 | ✅ | | 批量网页正文抓取 | ✅ | | 缺少 EXA_API_KEY 的明确报错 | ✅ | | 结果正文清洗与格式化输出 | ✅ |

Project Structure

owlfy-exa-mcp/
├── src/index.ts
├── dist/index.js
├── owlfy-exa-mcp.mjs
├── package.json
└── README.md

Installation

如果你已经有依赖环境：

cd /Users/fjc/Desktop/owlfy-exa-mcp
npm install
npm run build

当前目录已临时链接到本机现有的 node_modules，所以在这台机器上可以直接运行。

Quick Start

Direct Run

cd /Users/fjc/Desktop/owlfy-exa-mcp
EXA_API_KEY=your_exa_api_key node owlfy-exa-mcp.mjs

MCP Config

{
  "mcpServers": {
    "owlfy-exa-mcp": {
      "command": "node",
      "args": [
        "/Users/fjc/Desktop/owlfy-exa-mcp/owlfy-exa-mcp.mjs"
      ],
      "env": {
        "EXA_API_KEY": "your_exa_api_key"
      }
    }
  }
}

Smithery / 可配置环境变量注入

项目已提供 smithery.yaml，可将外部配置自动注入到 MCP 进程环境变量：

• apiKey -> EXA_API_KEY
• baseUrl -> EXA_BASE_URL

示例配置：

apiKey: your_exa_api_key
baseUrl: https://api.exa.ai

Tools

web_search_exa

参数：

• query: 自然语言搜索描述
• numResults: 返回结果数，默认 10

web_fetch_exa

参数：

• urls: 需要抓取的 URL 数组
• maxCharacters: 每个页面最大提取字符数，默认 3000

Build

cd /Users/fjc/Desktop/owlfy-exa-mcp
npm run build

Notes

• 运行前必须配置 EXA_API_KEY
• 默认 API 地址为 https://api.exa.ai
• 如需代理或私有网关，可设置 EXA_BASE_URL