概览
什么是 Exa MCP 服务器?
Exa MCP 服务器是一个强大的网络搜索 API,旨在促进模型上下文协议(MCP)。它充当各种应用程序与网络上可用的广泛资源之间的桥梁,使开发人员能够将搜索功能无缝集成到他们的项目中。Exa MCP 服务器是开源的,公开可用,是希望通过强大的搜索功能增强其应用程序的开发人员的绝佳选择。
Exa MCP 服务器的特点
- 网络搜索 API:提供全面的网络搜索 API,使应用程序能够快速高效地检索相关信息。
- 模型上下文协议:实现模型上下文协议,允许结构化数据的检索和交互。
- 开源:作为开源项目,开发人员可以参与其开发,根据自己的需求进行定制,并从社区支持中受益。
- 可扩展性:设计用于处理大量请求,适合小型和大型应用程序。
- 用户友好的文档:附带广泛的文档,帮助开发人员有效理解和实施 API。
如何使用 Exa MCP 服务器
- 安装:从 GitHub 克隆代码库,并按照文档中提供的安装说明进行操作。
- 配置:设置必要的配置,包括 API 密钥和端点设置,以根据您的特定需求调整服务器。
- 集成:使用 API 端点将搜索功能集成到您的应用程序中。这可能涉及发出 HTTP 请求以根据用户查询检索搜索结果。
- 测试:彻底测试集成,以确保搜索功能按预期工作并提供准确的结果。
- 部署:测试完成后,将集成了 Exa MCP 服务器的应用程序部署,以便用户使用。
常见问题解答
我可以使用哪些编程语言与 Exa MCP 服务器集成?
Exa MCP 服务器可以与任何支持 HTTP 请求的编程语言集成,包括但不限于 JavaScript、Python、Java 和 Ruby。
使用 Exa MCP 服务器是否需要费用?
不需要,Exa MCP 服务器是开源的,可以免费使用。然而,如果您在云服务上部署它或需要额外资源,可能会产生费用。
我如何为 Exa MCP 服务器做贡献?
您可以通过分叉代码库、进行改进并提交拉取请求来贡献。此外,报告问题和建议功能也是帮助社区的好方法。
我在哪里可以找到 Exa MCP 服务器的文档?
文档可在 GitHub 的代码库中找到。它包括安装说明、API 使用示例和配置细节。
我可以将 Exa MCP 服务器用于商业项目吗?
可以,由于它是开源的并且根据 MIT 许可证授权,您可以在商业项目中使用 Exa MCP 服务器而没有任何限制。
详情
Exa MCP Server 🔍
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Remote Exa MCP 🌐
Connect directly to Exa's hosted MCP server (instead of running it locally).
Remote Exa MCP URL
https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key
Replace your-api-key-here
with your actual Exa API key from dashboard.exa.ai/api-keys.
Claude Desktop Configuration for Remote MCP
Add this to your Claude Desktop configuration file:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key"
]
}
}
}
NPM Installation
npm install -g exa-mcp-server
Using Smithery
To install the Exa MCP server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install exa --client claude
Configuration ⚙️
1. Configure Claude Desktop to recognize the Exa MCP server
You can find claude_desktop_config.json inside the settings of Claude Desktop app:
Open the Claude Desktop app and enable Developer Mode from the top-left menu bar.
Once enabled, open Settings (also from the top-left menu bar) and navigate to the Developer Option, where you'll find the Edit Config button. Clicking it will open the claude_desktop_config.json file, allowing you to make the necessary edits.
OR (if you want to open claude_desktop_config.json from terminal)
For macOS:
- Open your Claude Desktop configuration:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
For Windows:
- Open your Claude Desktop configuration:
code %APPDATA%\Claude\claude_desktop_config.json
2. Add the Exa server configuration:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "exa-mcp-server"],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
Replace your-api-key-here
with your actual Exa API key from dashboard.exa.ai/api-keys.
3. Available Tools & Tool Selection
The Exa MCP server includes the following tools, which can be enabled by adding the --tools
:
- web_search_exa: Performs real-time web searches with optimized results and content extraction.
- research_paper_search: Specialized search focused on academic papers and research content.
- company_research: Comprehensive company research tool that crawls company websites to gather detailed information about businesses.
- crawling: Extracts content from specific URLs, useful for reading articles, PDFs, or any web page when you have the exact URL.
- competitor_finder: Identifies competitors of a company by searching for businesses offering similar products or services.
- linkedin_search: Search LinkedIn for companies and people using Exa AI. Simply include company names, person names, or specific LinkedIn URLs in your query.
- wikipedia_search_exa: Search and retrieve information from Wikipedia articles on specific topics, giving you accurate, structured knowledge from the world's largest encyclopedia.
- github_search: Search GitHub repositories using Exa AI - performs real-time searches on GitHub.com to find relevant repositories, issues, and GitHub accounts.
You can choose which tools to enable by adding the --tools
parameter to your Claude Desktop configuration:
Specify which tools to enable:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=web_search_exa,research_paper_search,company_research,crawling,competitor_finder,linkedin_search,wikipedia_search_exa,github_search"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
For enabling multiple tools, use a comma-separated list:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=web_search_exa,research_paper_search,company_research,crawling,competitor_finder,linkedin_search,wikipedia_search_exa,github_search"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
If you don't specify any tools, all tools enabled by default will be used.
4. Restart Claude Desktop
For the changes to take effect:
- Completely quit Claude Desktop (not just close the window)
- Start Claude Desktop again
- Look for the icon to verify the Exa server is connected
Using via NPX
If you prefer to run the server directly, you can use npx:
### Run with all tools enabled by default
npx exa-mcp-server
### Enable specific tools only
npx exa-mcp-server --tools=web_search_exa
### Enable multiple tools
npx exa-mcp-server --tools=web_search_exa,research_paper_search
### List all available tools
npx exa-mcp-server --list-tools
Troubleshooting 🔧
Common Issues
-
Server Not Found
- Verify the npm link is correctly set up
- Check Claude Desktop configuration syntax (json file)
-
API Key Issues
- Confirm your EXA_API_KEY is valid
- Check the EXA_API_KEY is correctly set in the Claude Desktop config
- Verify no spaces or quotes around the API key
-
Connection Issues
- Restart Claude Desktop completely
- Check Claude Desktop logs:
Built with ❤️ by team Exa
Server配置
{
"mcpServers": {
"exa-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--exa-labs--exa-mcp-server--exa-mcp-server",
"node ./.smithery/index.cjs"
],
"env": {
"EXA_API_KEY": "exa-api-key"
}
}
}
}