- Introduction
- What is Model Context Protocol (MCP)?
- Features
- Tools
- Installation
- Usage
- Configuration for Claude Desktop
- Configuration for VS Code with Cline
- Tips for Using with Different AI Agents
- Troubleshooting
- Contributing
- License
The fabric-mcp-server
is a Model Context Protocol (MCP) server designed to expose Daniel Miessler's Fabric patterns as tools for integration with AI coding agents and assistants. This integration enhances AI capabilities by leveraging AI-driven pattern execution from the Fabric repository. The server works with various AI platforms including Claude Desktop, Cline, and other MCP-compatible AI agents.
The Model Context Protocol (MCP) is a specification that facilitates communication between AI systems and external tools or resources. It standardizes the way AI models interact with various capabilities such as databases, APIs, and file systems. MCP servers, like fabric-mcp-server
, implement this protocol to make tools and resources accessible to AI models, thereby expanding their functional scope.
- Exposes Fabric Patterns as Tools: The server makes all Fabric patterns available as individual tools within MCP-compatible AI agents.
- Pattern Execution: Users can select and execute Fabric patterns directly within AI assistant tasks.
- Enhanced Capabilities: Integrates AI-driven pattern execution to augment AI assistant functionality.
- Cross-Platform Compatibility: Works with Claude Desktop, Cline, and other MCP-compatible AI agents.
The fabric-mcp-server
exposes a wide range of Fabric patterns as tools. Some examples include:
analyze_claims
summarize
extract_wisdom
create_mermaid_visualization
- And many more...
To see the full list of available patterns, you can list the directories in the [fabric/patterns](https://github.com/danielmiessler/Fabric/tree/main/data/patterns)
directory.
- Clone the Repository: Clone the
fabric-mcp-server
repository to your local system. - Install Dependencies: Navigate into the
fabric-mcp-server
directory and runnpm install
. - Build the Project: Run
npm run build
to compile the TypeScript code.
To use the fabric-mcp-server
with AI agents:
- Ensure the server is installed and running.
- Configure the MCP server in your AI agent's settings file.
- Create a new task or conversation and select a Fabric pattern to use.
The specific configuration steps vary depending on which AI agent you're using. See the sections below for detailed instructions.
To use fabric-mcp-server
with Claude Desktop:
-
Complete Installation: Follow the installation steps above to build the project.
-
Configure Claude Desktop: Add the MCP server configuration to your Claude Desktop settings. The configuration file is typically located at:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Linux:
~/.config/Claude/claude_desktop_config.json
- Windows:
-
Add Server Configuration: Add the following to your
claude_desktop_config.json
:
{
"mcpServers": {
"fabric-mcp-server": {
"command": "node",
"args": [
"<path-to-fabric-mcp-server>/build/index.js"
],
"env": {}
}
}
}
Replace <path-to-fabric-mcp-server>
with the actual path to the fabric-mcp-server
directory on your system.
- Restart Claude Desktop: Restart Claude Desktop to apply the changes.
To use fabric-mcp-server
with Cline in VS Code:
-
Complete Installation: Follow the installation steps above to build the project.
-
Configure Cline Settings: Add the MCP server configuration to your Cline settings file. The file path varies by operating system:
- Windows:
C:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
- macOS:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Linux:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows:
-
Add Server Configuration: Use the following configuration:
{
"fabric-mcp-server": {
"command": "node",
"args": [
"<path-to-fabric-mcp-server>/build/index.js"
],
"env": {},
"disabled": false,
"autoApprove": [],
"transportType": "stdio",
"timeout": 60
}
}
Replace <path-to-fabric-mcp-server>
with the actual path to the fabric-mcp-server
directory on your system. For example:
- Windows:
"C:\\path\\to\\fabric-mcp-server\\build\\index.js"
- macOS/Linux:
"/path/to/fabric-mcp-server/build/index.js"
- Restart VS Code: Restart VS Code or reload the Cline extension to apply the changes.
- Simply mention that you'd like to use a Fabric pattern in your conversation
- Ask Claude to list available patterns if you're unsure which one to use
- The patterns will be automatically available as tools once configured
To maximize the benefits of fabric-mcp-server
with Cline, add use fabric-mcp-server
at the end of your prompts or consider adding the following rule to your .clinerules
file:
# Fabric MCP Server Rule
1. **List Fabric Patterns**: When a new task is created, list all pattern names from the Fabric repository.
2. **Prompt for Pattern Selection**: Ask the user to select one of the following options:
a) Enter a pattern name from the list to use the `fabric-mcp-server` tool with the specified pattern.
b) Choose not to use `fabric-mcp-server` for the task.
This rule streamlines the tool selection process for new tasks in Cline.
- Consult your specific AI agent's documentation for MCP server configuration
- The basic server configuration should be similar to the examples above
- Ensure your agent supports the MCP protocol and tool execution
- Ensure the
fabric-mcp-server
is correctly configured in your AI agent's settings. - Verify that the server is running and reachable.
- Check the console output for any error messages.
- Make sure the path to the build/index.js file is correct and accessible.
- Verify that Node.js is installed and available in your system PATH.
Contributions to fabric-mcp-server
are welcome. Please refer to the CONTRIBUTING.md file for guidelines on how to contribute.
fabric-mcp-server
is released under the MIT License.