What is com.oods-foundry/foundry?

OODS Foundry is an object-oriented design system that extends the one you already have.

How do I install com.oods-foundry/foundry?

Clone com.oods-foundry/foundry from https://github.com/kneelinghorse/OODS-Foundry and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is com.oods-foundry/foundry open source?

Yes, com.oods-foundry/foundry is open source under the Apache-2.0 license. Source code is available at https://github.com/kneelinghorse/OODS-Foundry.

What category does com.oods-foundry/foundry belong to?

com.oods-foundry/foundry is listed under Other MCP servers on MCPFind.

com.oods-foundry/foundry — MCP Server for Other

OODS Foundry

OODS Foundry is an open source (Apache-2.0) design-system engine that your AI assistant drives over MCP. Describe a screen by its object and context, such as a subscription detail view. Foundry composes governed components and design tokens, generates React or Vue code, and renders charts from your data.

Use it when your product has recurring objects and workflows, your screens need to share rules across frameworks and themes, or you want generated UI to follow an existing design system. You can define your own objects, traits, brand and component mappings.

Generated code comes with a receipt naming the static checks performed and the work still needed. Chart certification measures the rendered specification's accuracy, accessibility equivalence, contrast and determinism. It does not certify an entire application.

The optional a11y_scan tool checks the text and icon contrast pairs declared by the component stylesheet in every built brand and theme. Given a screen schema, it also renders the screen and checks its document accessibility rules; see the tool reference for scope and thresholds.

Install

Use Node.js 22.0.0 or newer on macOS or Linux. For a local server in Claude Code:

claude mcp add oods-foundry -- npx -y @oods/foundry@0.8.0
claude mcp get oods-foundry

For the Claude Code plugin, which includes the server and its guided skill:

claude plugin marketplace add https://github.com/kneelinghorse/oods-foundry-claude-plugin.git
claude plugin install oods-foundry@oods-foundry

Restart Claude Code and invoke /oods-foundry:oods-foundry. Ask your assistant to call health_check, then compose a Subscription in detail context. The package guide includes Claude Desktop and Cursor configuration and explains local files and network access. The walkthrough takes you from an object definition to a generated application.

For a hosted connection, use the streamable HTTP endpoint https://oods-foundry.com/mcp in a compatible MCP client. The website describes its available tools. Local installation provides the full authoring workflow; the hosted service has its own tool surface and release schedule.

Docker stdio server

Build the supplied Dockerfile, then keep stdin open for your MCP client:

docker build -t oods-foundry:0.8.0 .
docker run --rm -i -v oods-data:/data oods-foundry:0.8.0

The image runs as the unprivileged node user. The volume preserves registered objects and import drafts. Mount schema files separately, for example -v "$PWD/schemas:/schemas:ro", and give object_import their container paths. The running-app preview binds to loopback inside the container; use the local npm installation for browser previews on the host.

Source and releases

This repository mirrors each release, one commit per version. The source includes the design system, React and Vue libraries, MCP server, bridge, adapter and packaging scripts. The tool reference describes the calls and their contracts.

To install the workspace from this snapshot:

corepack pnpm install --frozen-lockfile

Building and testing from source describes the package builds, runtime assembly and public test command.

Bug reports and feedback are welcome in Issues. This release mirror does not accept pull requests; they will be closed. See CONTRIBUTING and SECURITY.

License

OODS Foundry is licensed under Apache-2.0; see NOTICE for the copyright holder, third-party notices and the license FAQ.

Commits before the release snapshot carried an MIT declaration in package.json and no LICENSE file.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "com-oods-foundry-foundry": {
      "command": "npx",
      "args": [
        "-y",
        "@oods/foundry"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

com.oods-foundry/foundry works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

com.oods-foundry/foundry