网络搜索与分析服务

Quercle MCP服务器为AI驱动的网络搜索和页面抓取提供支持,使Claude等MCP客户端能够搜索网络并抓取和分析页面内容。

  • by quercledev
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 quercledev/quercle-mcp

使用说明

@quercle/mcp

An MCP server for Quercle — AI-powered web search and fetch.

Gives Claude (and any MCP client) the ability to search the web and fetch + analyze pages.

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "quercle": {
      "command": "npx",
      "args": ["-y", "@quercle/mcp"],
      "env": {
        "QUERCLE_API_KEY": "qk_..."
      }
    }
  }
}

Restart Claude Desktop. You'll see the Quercle tools available in the chat.

Claude Code

claude mcp add --transport stdio --env QUERCLE_API_KEY=qk_... quercle -- npx -y @quercle/mcp

Global Install (alternative)

npm install -g @quercle/mcp

Then reference quercle-mcp instead of npx -y @quercle/mcp in your config.

Setup

Get your API key at quercle.dev and set it in the config as shown above.

Tools

The server exposes five tools:

search

Search the web and get an AI-synthesized answer with citations.

Parameter Required Description
query Yes The search query
allowedDomains No Only return results from these domains
blockedDomains No Exclude results from these domains

fetch

Fetch a URL and analyze its content with AI.

Parameter Required Description
url Yes The URL to fetch
prompt Yes Instructions for how to analyze the page content

raw_search

Search the web and get raw results (without AI synthesis).

Parameter Required Description
query Yes The search query
format No Response format: markdown (default) or json
useSafeguard No Enable content safeguards (boolean)

raw_fetch

Fetch raw content from a URL without AI processing.

Parameter Required Description
url Yes The URL to fetch
format No Response format: markdown (default) or html
useSafeguard No Enable content safeguards (boolean)

extract

Extract relevant content from a URL based on a query.

Parameter Required Description
url Yes The URL to extract content from
query Yes What to extract from the page
format No Response format: markdown (default) or json
useSafeguard No Enable content safeguards (boolean)

Troubleshooting

Issue Solution
"Missing API key" Set QUERCLE_API_KEY in the env section of your config
"Invalid API key" Check your key starts with qk_ and is valid at quercle.dev
Timeout errors The API may take up to 60s for complex queries — this is normal
Server not connecting Run npx -y @quercle/mcp directly to check for errors

License

MIT