Macroforge MCP Server
# @macroforge/mcp-server
MCP server for Macroforge documentation and code analysis
[](https://www.npmjs.com/package/@macroforge/mcp-server)
## Overview
@macroforge/mcp-server
Macroforge MCP (Model Context Protocol) Server
This module provides the main entry point for the Macroforge MCP server, which enables AI assistants
and other MCP clients to access Macroforge documentation, validate code with @derive decorators, and
expand macros.
The server communicates over stdio transport and exposes the following tools:
- `list-sections` - List available documentation sections
- `get-documentation` - Retrieve documentation content
- `macroforge-autofixer` - Validate TypeScript code with @derive decorators
- `expand-code` - Expand Macroforge macros and show generated code
- `get-macro-info` - Get documentation for macros and decorators
@example
```bash
# Run the server directly
npx @macroforge/mcp-server
# Or configure in your MCP client settings
{
"mcpServers": {
"macroforge": {
"command": "npx",
"args": ["@macroforge/mcp-server"]
}
}
}
```
## Installation
```bash
npm install @macroforge/mcp-server
```
## Examples
```typescript
# Run the server directly
npx @macroforge/mcp-server
# Or configure in your MCP client settings
{
"mcpServers": {
"macroforge": {
"command": "npx",
"args": ["@macroforge/mcp-server"]
}
}
}
```
## Documentation
See the [full documentation](https://macroforge.dev/docs/api/reference/typescript/mcp-server) on the
Macroforge website.
## License
MIT
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: expand-code transforms TypeScript code, get-documentation retrieves documentation content, get-macro-info provides macro/decorator details, list-sections lists documentation sections, and macroforge-autofixer validates code. The descriptions clearly differentiate their functions, making misselection unlikely.
The naming is mostly consistent with a verb_noun pattern (expand-code, get-documentation, get-macro-info, list-sections), but macroforge-autofixer deviates slightly by using a compound noun prefix instead of a verb. This minor inconsistency doesn't significantly hinder readability or predictability.
With 5 tools, this server is well-scoped for its purpose of Macroforge macro handling and documentation. Each tool earns its place by covering distinct aspects like code expansion, documentation retrieval, macro info, section listing, and validation, providing a complete workflow without being overly sparse or bloated.
The tool set offers complete coverage for the Macroforge domain: expand-code handles code transformation, get-documentation and get-macro-info cover documentation needs, list-sections supports discovery, and macroforge-autofixer ensures validation. This covers the full lifecycle from setup and usage to debugging and validation, with no obvious gaps.