Alibaba Cloud OpenSearch MCP Server

Name: Alibaba Cloud OpenSearch MCP Server
Author: Alibaba Cloud

Alibaba CloudOfficialChina

Get started Repository

Gives agents tools to work with Alibaba Cloud OpenSearch through a standard interface.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add alibaba-cloud-opensearch --env AISEARCH_API_KEY='<AISEARCH_API_KEY>' --env AISEARCH_ENDPOINT='<AISEARCH_ENDPOINT>' --env OPENSEARCH_VECTOR_ENDPOINT='<OPENSEARCH_VECTOR_ENDPOINT>' --env OPENSEARCH_VECTOR_INDEX_NAME='<OPENSEARCH_VECTOR_INDEX_NAME>' --env OPENSEARCH_VECTOR_INSTANCE_ID='<OPENSEARCH_VECTOR_INSTANCE_ID>' --env OPENSEARCH_VECTOR_PASSWORD='<OPENSEARCH_VECTOR_PASSWORD>' --env OPENSEARCH_VECTOR_USERNAME='<OPENSEARCH_VECTOR_USERNAME>' -- uv --directory /path/to/aisearch-mcp-server run aisearch-mcp-server

~/.codex/config.toml

[mcp_servers.alibaba-cloud-opensearch]
command = "uv"
args = ["--directory", "/path/to/aisearch-mcp-server", "run", "aisearch-mcp-server"]
env = { AISEARCH_API_KEY = "<AISEARCH_API_KEY>", AISEARCH_ENDPOINT = "<AISEARCH_ENDPOINT>", OPENSEARCH_VECTOR_ENDPOINT = "<OPENSEARCH_VECTOR_ENDPOINT>", OPENSEARCH_VECTOR_INDEX_NAME = "<OPENSEARCH_VECTOR_INDEX_NAME>", OPENSEARCH_VECTOR_INSTANCE_ID = "<OPENSEARCH_VECTOR_INSTANCE_ID>", OPENSEARCH_VECTOR_PASSWORD = "<OPENSEARCH_VECTOR_PASSWORD>", OPENSEARCH_VECTOR_USERNAME = "<OPENSEARCH_VECTOR_USERNAME>" }

# codex mcp add alibaba-cloud-opensearch --env AISEARCH_API_KEY='<AISEARCH_API_KEY>' --env AISEARCH_ENDPOINT='<AISEARCH_ENDPOINT>' --env OPENSEARCH_VECTOR_ENDPOINT='<OPENSEARCH_VECTOR_ENDPOINT>' --env OPENSEARCH_VECTOR_INDEX_NAME='<OPENSEARCH_VECTOR_INDEX_NAME>' --env OPENSEARCH_VECTOR_INSTANCE_ID='<OPENSEARCH_VECTOR_INSTANCE_ID>' --env OPENSEARCH_VECTOR_PASSWORD='<OPENSEARCH_VECTOR_PASSWORD>' --env OPENSEARCH_VECTOR_USERNAME='<OPENSEARCH_VECTOR_USERNAME>' -- uv --directory /path/to/aisearch-mcp-server run aisearch-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "alibaba-cloud-opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aisearch-mcp-server",
        "run",
        "aisearch-mcp-server"
      ],
      "env": {
        "AISEARCH_API_KEY": "<AISEARCH_API_KEY>",
        "AISEARCH_ENDPOINT": "<AISEARCH_ENDPOINT>",
        "OPENSEARCH_VECTOR_ENDPOINT": "<OPENSEARCH_VECTOR_ENDPOINT>",
        "OPENSEARCH_VECTOR_INDEX_NAME": "<OPENSEARCH_VECTOR_INDEX_NAME>",
        "OPENSEARCH_VECTOR_INSTANCE_ID": "<OPENSEARCH_VECTOR_INSTANCE_ID>",
        "OPENSEARCH_VECTOR_PASSWORD": "<OPENSEARCH_VECTOR_PASSWORD>",
        "OPENSEARCH_VECTOR_USERNAME": "<OPENSEARCH_VECTOR_USERNAME>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "alibaba-cloud-opensearch": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aisearch-mcp-server",
        "run",
        "aisearch-mcp-server"
      ],
      "env": {
        "AISEARCH_API_KEY": "<AISEARCH_API_KEY>",
        "AISEARCH_ENDPOINT": "<AISEARCH_ENDPOINT>",
        "OPENSEARCH_VECTOR_ENDPOINT": "<OPENSEARCH_VECTOR_ENDPOINT>",
        "OPENSEARCH_VECTOR_INDEX_NAME": "<OPENSEARCH_VECTOR_INDEX_NAME>",
        "OPENSEARCH_VECTOR_INSTANCE_ID": "<OPENSEARCH_VECTOR_INSTANCE_ID>",
        "OPENSEARCH_VECTOR_PASSWORD": "<OPENSEARCH_VECTOR_PASSWORD>",
        "OPENSEARCH_VECTOR_USERNAME": "<OPENSEARCH_VECTOR_USERNAME>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "alibaba-cloud-opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aisearch-mcp-server",
        "run",
        "aisearch-mcp-server"
      ],
      "env": {
        "AISEARCH_API_KEY": "<AISEARCH_API_KEY>",
        "AISEARCH_ENDPOINT": "<AISEARCH_ENDPOINT>",
        "OPENSEARCH_VECTOR_ENDPOINT": "<OPENSEARCH_VECTOR_ENDPOINT>",
        "OPENSEARCH_VECTOR_INDEX_NAME": "<OPENSEARCH_VECTOR_INDEX_NAME>",
        "OPENSEARCH_VECTOR_INSTANCE_ID": "<OPENSEARCH_VECTOR_INSTANCE_ID>",
        "OPENSEARCH_VECTOR_PASSWORD": "<OPENSEARCH_VECTOR_PASSWORD>",
        "OPENSEARCH_VECTOR_USERNAME": "<OPENSEARCH_VECTOR_USERNAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "alibaba-cloud-opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aisearch-mcp-server",
        "run",
        "aisearch-mcp-server"
      ],
      "env": {
        "AISEARCH_API_KEY": "<AISEARCH_API_KEY>",
        "AISEARCH_ENDPOINT": "<AISEARCH_ENDPOINT>",
        "OPENSEARCH_VECTOR_ENDPOINT": "<OPENSEARCH_VECTOR_ENDPOINT>",
        "OPENSEARCH_VECTOR_INDEX_NAME": "<OPENSEARCH_VECTOR_INDEX_NAME>",
        "OPENSEARCH_VECTOR_INSTANCE_ID": "<OPENSEARCH_VECTOR_INSTANCE_ID>",
        "OPENSEARCH_VECTOR_PASSWORD": "<OPENSEARCH_VECTOR_PASSWORD>",
        "OPENSEARCH_VECTOR_USERNAME": "<OPENSEARCH_VECTOR_USERNAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "alibaba-cloud-opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aisearch-mcp-server",
        "run",
        "aisearch-mcp-server"
      ],
      "env": {
        "AISEARCH_API_KEY": "<AISEARCH_API_KEY>",
        "AISEARCH_ENDPOINT": "<AISEARCH_ENDPOINT>",
        "OPENSEARCH_VECTOR_ENDPOINT": "<OPENSEARCH_VECTOR_ENDPOINT>",
        "OPENSEARCH_VECTOR_INDEX_NAME": "<OPENSEARCH_VECTOR_INDEX_NAME>",
        "OPENSEARCH_VECTOR_INSTANCE_ID": "<OPENSEARCH_VECTOR_INSTANCE_ID>",
        "OPENSEARCH_VECTOR_PASSWORD": "<OPENSEARCH_VECTOR_PASSWORD>",
        "OPENSEARCH_VECTOR_USERNAME": "<OPENSEARCH_VECTOR_USERNAME>"
      }
    }
  }
}

Environment variables

AISEARCH_API_KEY
AISEARCH_ENDPOINT
OPENSEARCH_VECTOR_ENDPOINT
OPENSEARCH_VECTOR_INDEX_NAME
OPENSEARCH_VECTOR_INSTANCE_ID
OPENSEARCH_VECTOR_PASSWORD
OPENSEARCH_VECTOR_USERNAME

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related