home / mcp / metal mcp server

Metal MCP Server

Provides Metal Framework documentation search and code generation capabilities via MCP protocol.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "aldrin-labs-metal-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/metal-mcp/build/index.js"
      ]
    }
  }
}

You can run a Metal MCP Server that provides quick access to Metal Framework documentation via natural language search and generates ready-to-use Metal code. This server exposes two core tools you can call from any MCP client to search docs and generate code, helping you learn and implement Metal tasks faster.

How to use

You access the Metal MCP Server through any MCP client by configuring it as a local, stdio-based server. The server offers two primary capabilities: searching Metal Framework documentation with natural language queries and generating Metal code snippets for common tasks. Use these tools to rapidly find getting-started guides, best practices, and sample code, then adapt the generated snippets to your project.

How to install

Prerequisites: Node.js (LTS version) and npm installed on your system.

Run the following command to scaffold and set up the Metal MCP Server, then navigate into the project and install dependencies, finally build the server.

npx @modelcontextprotocol/create-server metal-mcp && cd metal-mcp && npm install && npm run build

MCP configuration to run with your client

After building, add the Metal MCP Server to your MCP client configuration so it can be started by your MCP runtime. Use the stdio-based runtime command as shown.

{
  "mcpServers": {
    "metal": {
      "command": "node",
      "args": ["/path/to/metal-mcp/build/index.js"]
    }
  }
}

Notes on usage patterns

- Use search_metal_docs to look up Metal Framework topics or code examples by asking a natural language question. You can limit results to three items by setting the limit parameter.

- Use generate_metal_code to obtain boilerplate Metal code for common tasks in your preferred language (objective-c, swift, or metal).

Additional guidance

The server is designed to be integrated into your existing MCP workflow. Observe any project-wide coding standards when applying generated snippets, and validate generated code in a safe development environment before committing to production.

Available tools

search_metal_docs

Search Metal Framework documentation and code examples using natural language queries, returning a configurable number of results (default 3).

generate_metal_code

Generate Metal Framework code for common tasks in your preferred language (objective-c, swift, or metal).