Alibaba Cloud OpenSearch
This MCP server equips AI Agents with tools to interact with OpenSearch through a standardized and extensible interface. See our product document for more information.
What is Alibaba Cloud OpenSearch?
Alibaba Cloud OpenSearch is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this mcp server equips ai agents with tools to interact with opensearch through a standardized and extensible interface. see our product document for more information.
This MCP server equips AI Agents with tools to interact with OpenSearch through a standardized and extensible interface. See our product document for more information.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This MCP server equips AI Agents with tools to interact with
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx alibabacloud-opensearchConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Alibaba Cloud OpenSearch
Alibaba Cloud OpenSearch MCP Server provides AI agents with a standardized interface to the Alibaba Cloud AI Search platform, enabling document analysis, image parsing, text embedding and sparse embedding, semantic reranking, web search, and natural language query analysis for building advanced RAG and conversational search pipelines.
Prerequisites
- Python 3.10 or later installed
- uv package manager installed
- Alibaba Cloud account with AI Search (OpenSearch) service enabled
- AISEARCH_API_KEY obtained from the Alibaba Cloud console
- AISEARCH_ENDPOINT URL for your OpenSearch instance
Clone the repository
The server is not on PyPI, so clone the GitHub repository to your local machine and navigate into the aisearch-mcp-server subdirectory.
git clone https://github.com/aliyun/alibabacloud-opensearch-mcp-server.git
cd alibabacloud-opensearch-mcp-server/aisearch-mcp-serverObtain your API key and endpoint from Alibaba Cloud
Log in to the Alibaba Cloud console, navigate to AI Search (OpenSearch), create or select an instance, and copy the API key and endpoint URL from the instance details page.
Configure the MCP client
Add the aisearch-mcp-server to your claude_desktop_config.json using the uv command, pointing to the cloned directory and supplying the API key and endpoint as environment variables.
{
"mcpServers": {
"aisearch-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/alibabacloud-opensearch-mcp-server/aisearch-mcp-server",
"run",
"aisearch-mcp-server"
],
"env": {
"AISEARCH_API_KEY": "your_api_key_here",
"AISEARCH_ENDPOINT": "https://your-instance.aliyuncs.com"
}
}
}
}Restart Claude Desktop and confirm tools are available
Restart Claude Desktop after saving the config. Claude should now have access to document_analyze, text_embedding, rerank, web_search, and other OpenSearch tools.
Alibaba Cloud OpenSearch Examples
Client configuration
claude_desktop_config.json entry for the Alibaba Cloud AISearch MCP server using uv to run from the cloned repo directory.
{
"mcpServers": {
"aisearch-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/Users/yourname/alibabacloud-opensearch-mcp-server/aisearch-mcp-server",
"run",
"aisearch-mcp-server"
],
"env": {
"AISEARCH_API_KEY": "sk-xxxxxxxxxxxxxxxx",
"AISEARCH_ENDPOINT": "https://your-instance.aliyuncs.com"
}
}
}
}Prompts to try
Example prompts to use with the Alibaba Cloud OpenSearch MCP server once connected to Claude Desktop.
- "Extract the text and structure from this PDF document at URL https://example.com/report.pdf"
- "Generate a text embedding vector for the sentence 'AI-powered search solutions'"
- "Rerank these 5 candidate passages by relevance to the query 'cloud database performance'"
- "Search the web for the latest news about Alibaba Cloud AI services"
- "Analyze my query 'find contracts signed in 2023' and convert it to a SQL filter expression"
- "Split this HTML article into semantic paragraphs for indexing"Troubleshooting Alibaba Cloud OpenSearch
Server fails to start with 'command not found: uv'
Install uv with: curl -LsSf https://astral.sh/uv/install.sh | sh, then restart your terminal. Ensure the uv binary is on your PATH.
API returns 401 Unauthorized
Double-check that AISEARCH_API_KEY is set correctly in the env block and that the key has permissions for the AI Search service. Generate a new key from the Alibaba Cloud console if needed.
Tools are not visible in Claude Desktop after restarting
Verify the --directory path in the args array points to the aisearch-mcp-server subdirectory (not the repo root). Check Claude Desktop logs under Help > Show Logs for startup errors.
Frequently Asked Questions about Alibaba Cloud OpenSearch
What is Alibaba Cloud OpenSearch?
Alibaba Cloud OpenSearch is a Model Context Protocol (MCP) server that this mcp server equips ai agents with tools to interact with opensearch through a standardized and extensible interface. see our product document for more information. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Alibaba Cloud OpenSearch?
Follow the installation instructions on the Alibaba Cloud OpenSearch GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Alibaba Cloud OpenSearch?
Alibaba Cloud OpenSearch works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Alibaba Cloud OpenSearch free to use?
Yes, Alibaba Cloud OpenSearch is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Alibaba Cloud OpenSearch Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Alibaba Cloud OpenSearch? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Alibaba Cloud OpenSearch in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Alibaba Cloud OpenSearch?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.