Provider-neutral web search that combines model grounding (Gemini, Grok, DeepSeek and others) with search APIs such as Exa, Brave and Tavily.
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude mcp add agent-web-search --env ARK_API_KEY='<ARK_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env AGENT_WEB_SEARCH_RESPONSES_API_KEY='<AGENT_WEB_SEARCH_RESPONSES_API_KEY>' --env AGENT_WEB_SEARCH_MESSAGES_API_KEY='<AGENT_WEB_SEARCH_MESSAGES_API_KEY>' --env TAVILY_API_KEY='<TAVILY_API_KEY>' --env BRAVE_SEARCH_API_KEY='<BRAVE_SEARCH_API_KEY>' -- uvx agent-web-search-mcp~/.codex/config.toml
[mcp_servers.agent-web-search]
command = "uvx"
args = ["agent-web-search-mcp"]
env = { ARK_API_KEY = "<ARK_API_KEY>", GEMINI_API_KEY = "<GEMINI_API_KEY>", XAI_API_KEY = "<XAI_API_KEY>", DEEPSEEK_API_KEY = "<DEEPSEEK_API_KEY>", AGENT_WEB_SEARCH_RESPONSES_API_KEY = "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>", AGENT_WEB_SEARCH_MESSAGES_API_KEY = "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>", TAVILY_API_KEY = "<TAVILY_API_KEY>", BRAVE_SEARCH_API_KEY = "<BRAVE_SEARCH_API_KEY>" }
# codex mcp add agent-web-search --env ARK_API_KEY='<ARK_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env AGENT_WEB_SEARCH_RESPONSES_API_KEY='<AGENT_WEB_SEARCH_RESPONSES_API_KEY>' --env AGENT_WEB_SEARCH_MESSAGES_API_KEY='<AGENT_WEB_SEARCH_MESSAGES_API_KEY>' --env TAVILY_API_KEY='<TAVILY_API_KEY>' --env BRAVE_SEARCH_API_KEY='<BRAVE_SEARCH_API_KEY>' -- uvx agent-web-search-mcp~/.cursor/mcp.json
{
"mcpServers": {
"agent-web-search": {
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"agent-web-search": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"agent-web-search": {
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"agent-web-search": {
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"agent-web-search": {
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>"
}
}
}
}需要的环境变量
ARK_API_KEYGEMINI_API_KEYXAI_API_KEYDEEPSEEK_API_KEYAGENT_WEB_SEARCH_RESPONSES_API_KEYAGENT_WEB_SEARCH_MESSAGES_API_KEYTAVILY_API_KEYBRAVE_SEARCH_API_KEY
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。