Overview
What is kam-mcp-server?
kam-mcp-server is a Model Context Protocol (MCP) server built with mcp-framework. It provides a set of tools for creating and managing design elements (point-based, line-based, surface-based), retrieving view elements, available family types, and element details by ID, as well as a documentation resource (KamDocResource). The server is intended for use with MCP-compatible clients like Claude Desktop.
How to use kam-mcp-server?
Install dependencies with npm install, then build with npm run build (or yarn build). After publishing to npm, configure it in Claude Desktop by adding the server entry to claude_desktop_config.json using npx -y kam-mcp-server --port=9099. The server can also be run locally via npm link and the CLI command kam-mcp-server.
Key features of kam-mcp-server
- Create point-based, line-based, and surface-based elements.
- Retrieve elements in the current view.
- Get available family types.
- Delete elements by ID.
- Get element details by ID.
- Provides a KamDoc documentation resource.
Use cases of kam-mcp-server
- Automating repetitive element creation in a design or modeling application.
- Querying all elements currently visible in a view.
- Looking up a specific element’s properties by its ID.
- Removing unwanted elements programmatically.
- Retrieving available family types for use in other tools.
FAQ from kam-mcp-server
What tools does kam-mcp-server provide?
It includes CreatePointBasedElementTool, CreateLineBasedElementTool, CreateSurfaceBasedElementTool, GetCurrentViewElementsTool, GetAvailableFamilyTypesTool, DeleteElementTool, and GetElementByIdTool.
How do I install kam-mcp-server?
Run npm install in the project directory, then npm run build to compile. For global use, publish to npm and install via npx.
How do I configure kam-mcp-server with Claude Desktop?
Add the following entry to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"kam-mcp-server": {
"command": "npx",
"args": ["-y", "kam-mcp-server", "--port=9099"]
}
}
}
What port does kam-mcp-server use?
The server is configured to run on port 9099.
What runtime does kam-mcp-server require?
It requires Node.js and npm (or yarn) to build and run. It is built with the mcp-framework.
