AtScale's MCP Server

This server supports the Model Context Protocol (MCP) standard from Anthropic. It takes requests from mcp clients like Claude and returns information or query results from an AtScale instance.

To build the package: mvn clean package

Or download from here

To run the server (updating the jar name if needed): java -jar <path-to-jar> <JDBC URL>

Example:

java -jar target/atscale-mcp-server-1.0-SNAPSHOT.jar "jdbc:postgresql://localhost:15432/simple-sales-test_main"

Note: One catalog is required in the URL however all deployed models are available to the client.

Install the free Claude desktop application: https://claude.ai/download

Open up the Claude menu and select “Settings…”.

Click on “Developer” in the left-hand bar of the Settings pane, then click on “Edit Config”. This will create a configuration file at:

• MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: $env:AppData\Claude\claude_desktop_config.json

Replace the contents with the following, or if other mcpServers are being used with Claude just add the atscale-mcp-server section. Be sure to replace the jdbc url, user and pw:

{
  "mcpServers": {
    "atscale-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "path-to-AtScaleInc-in-git>/samples/atscale-mcp-server/target/atscale-mcp-server-1.0-SNAPSHOT.jar",
        "<jdbc url to deployed atscale catalog>?user=atscale-kc-admin&password=<pw>"
      ]
    }
  }
}

Note: If the user and password are not included in the jdbc url then Claude will request them from the user in order to authenticate.

Start Claude. Click on the "Search and tools" button under the text entry box. You should see "atscale-mcp-server" listed with 5 available tools.

Ask questions like "What AtScale models are available?" to get started.

The main log file is located with the Claude logs. Possible location on mac: ~/Library/Logs/Claude/mcp-server-atscale-mcp-server.log

Debugging MCP servers information is here

Note: Issues were encountered trying to run the MCP Inspector with the atscale-mcp-server so that has not yet been used. Logging messages were used to troubleshoot issues.

•  atscale-mcp-server.zip9 MB