SAP Search MCP Server v2.0

Enterprise MCP server for semantic search over SAP S/4HANA test cases using Azure AI Search.

Features

✅ 2-Tool Architecture - Lightweight summaries + on-demand details
✅ Markdown Tables - Procedure steps in clean table format
✅ Auto-Upload - Documents uploaded automatically on first run
✅ Vector Search - Semantic search using Azure OpenAI embeddings
✅ 240+ SAP Test Cases - S/4HANA 2023 FPS02 Business Process Documents

Quick Start

1. Install

pip install sap-search-mcp

2. Set Environment Variables

Create a .env file:

# Azure AI Search
AZURE_SEARCH_ENDPOINT=https://your-service.search.windows.net
AZURE_SEARCH_KEY=your_key

# Azure OpenAI (for embeddings)
AZURE_SEARCH_OPENAI_ENDPOINT=https://your-openai.cognitiveservices.azure.com/
AZURE_SEARCH_OPENAI_KEY=your_key

# Optional
INDEX_KNOWLEDGEHOUSE=knowledgehouse-en
INDEX_QUERYTABLE=querytable
EMBEDDING_MODEL=text-embedding-3-large

3. Use with Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "sap-search": {
      "command": "sap-search-mcp",
      "env": {
        "AZURE_SEARCH_ENDPOINT": "https://your-service.search.windows.net",
        "AZURE_SEARCH_KEY": "your_key",
        "AZURE_SEARCH_OPENAI_ENDPOINT": "https://your-openai.cognitiveservices.azure.com/",
        "AZURE_SEARCH_OPENAI_KEY": "your_key"
      }
    }
  }
}

Restart Claude Desktop.

Tools

1. search_sap_test_cases

Search SAP test cases with flexible results.

Single result (full details):

{"prompt": "Create purchase order", "top_k": 1}

Multiple summaries:

{"prompt": "Invoice processing", "top_k": 5}

2. get_test_case_details

Get full procedure table for a specific test case.

{
  "section_header": "Create Purchase Order - ME21N",
  "original_prompt": "purchase order"
}

Example Usage

User: "Show me 5 test cases for sales orders"
→ Returns 5 lightweight summaries

User: "Show me details for option 2"
→ Returns full procedure table in markdown format

Manual Upload (Optional)

Documents are uploaded automatically on first run. To manually re-upload:

sap-search-upload

Development

git clone <repo>
cd sap_search_mcp
pip install -e .
python test.py

What's New in v2.0

• 🎯 Simplified 2-tool architecture (was 3 tools)
• 📊 Markdown table formatting for procedures
• 🚀 Auto-upload on server start
• ⚡ Lightweight summaries for multiple results
• 🎨 Better output formatting

License

MIT