JSPM

@mdapp/mcp-client

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Score
    100M100P100Q9030F
  • License MIT

MCP proxy client for MDApp Documentation Manager

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@mdapp/mcp-client) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @mdapp/mcp-client

    MCP proxy client for MDApp Documentation Manager. Connect your IDE (Amazon Q, Cursor, Claude Desktop) to your MDApp workspace.

    Installation

    npm install -g @mdapp/mcp-client

    Setup

    1. Get Your API Key

    1. Visit https://md.qdox.online/settings
    2. Click "Generate New Key"
    3. Copy your API key (shown only once!)

    2. Configure Your IDE

    Amazon Q

    Edit %USERPROFILE%\.aws\amazonq\mcp.json (Windows) or ~/.aws/amazonq/mcp.json (Mac/Linux):

    {
  "mcpServers": {
    "mdapp": {
      "command": "mdapp-mcp",
      "env": {
        "MDAPP_API_KEY": "your_api_key_here"
      }
    }
  }
}

    Cursor

    Edit %APPDATA%\Cursor\User\globalStorage\mcp.json (Windows) or ~/Library/Application Support/Cursor/User/globalStorage/mcp.json (Mac):

    {
  "mcpServers": {
    "mdapp": {
      "command": "mdapp-mcp",
      "env": {
        "MDAPP_API_KEY": "your_api_key_here"
      }
    }
  }
}

    Claude Desktop

    Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

    {
  "mcpServers": {
    "mdapp": {
      "command": "mdapp-mcp",
      "env": {
        "MDAPP_API_KEY": "your_api_key_here"
      }
    }
  }
}

    3. Restart Your IDE

    Completely restart your IDE to load the new MCP configuration.

    Usage

    Amazon Q

    @mdapp list my workspaces
@mdapp search for "authentication"
@mdapp create document "API Guide" in workspace 1, category 2
@mdapp get document 5

    Cursor

    @mdapp list workspaces
@mdapp semantic search "React hooks"

    Claude Desktop

    Use the mdapp tool to list workspaces
Use the mdapp tool to search documents

    Available Commands

    • list_workspaces - List all your workspaces
    • get_workspace - Get workspace details
    • create_workspace - Create new workspace
    • list_categories - List categories in workspace
    • create_category - Create new category
    • list_documents - List documents
    • get_document - Get document content
    • create_document - Create new document
    • update_document - Update document
    • search_documents - Keyword search
    • semantic_search - AI-powered search
    • hybrid_search - Combined search
    • And 20+ more tools...

    Troubleshooting

    "MDAPP_API_KEY environment variable is required"

    Make sure you've added your API key to the MCP config file.

    "API error: 401 Unauthorized"

    Your API key is invalid or expired. Generate a new one at https://md.qdox.online/settings

    MCP not showing in IDE

    1. Check config file exists and has correct JSON syntax
    2. Verify mdapp-mcp is installed: mdapp-mcp --version
    3. Restart IDE completely
    4. Check IDE logs for errors

    Connection timeout

    Check your internet connection and verify https://md.qdox.online is accessible.

    Support