Fabric MCP Server
| main | develop | |||
|---|---|---|---|---|
 |
 |
 |
 |
Connect the power of the Fabric AI framework to any Model Context Protocol (MCP) compatible application.
This project implements a standalone server that bridges the gap between Daniel Miessler's Fabric framework and the Model Context Protocol (MCP). It allows you to use Fabric's patterns, models, and configurations directly within MCP-enabled environments like IDE extensions or chat interfaces.
Imagine seamlessly using Fabric's specialized prompts for code explanation, refactoring, or creative writing right inside your favorite tools!
Table of Contents
What is this?
- Fabric: An open-source framework for augmenting human capabilities using AI, focusing on prompt engineering and modular AI workflows.
- MCP: An open standard protocol enabling AI applications (like IDEs) to securely interact with external tools and data sources (like this server).
- Fabric MCP Server: This project acts as an MCP server, translating MCP requests into calls to a running Fabric instance's REST API (
fabric --serve).
Key Goals & Features (Based on Design)
- Seamless Integration: Use Fabric patterns and capabilities directly within MCP clients without switching context.
- Enhanced Workflows: Empower LLMs within IDEs or other tools to leverage Fabric's specialized prompts and user configurations.
- Standardization: Adhere to the open MCP standard for AI tool integration.
- Leverage Fabric Core: Build upon the existing Fabric CLI and REST API without modifying the core Fabric codebase.
- Expose Fabric Functionality: Provide MCP tools to list patterns, get pattern details, run patterns, list models/strategies, and retrieve configuration.
- Expose Pattern Prompts: Fabric patterns are also exposed as MCP prompts so users can discover and invoke reusable pattern templates directly through prompt-aware clients.
How it Works
- An MCP Host (e.g., an IDE extension) connects to this Fabric MCP Server.
- The Host discovers available tools (like
fabric_run_pattern) via MCP'slist_tools()mechanism and available Fabric pattern templates via MCP'sprompts/listmechanism. - When the user invokes a tool or prompt (e.g., asking the IDE's AI assistant to refactor code using a Fabric pattern), the Host sends an MCP request to this server.
- The Fabric MCP Server translates the MCP request into a corresponding REST API call to a running
fabric --serveinstance. - The
fabric --serveinstance executes the pattern. - The Fabric MCP Server receives the response (potentially streaming) from Fabric and translates it back into an MCP response for the Host.
Project Status
This project is feature-complete.
The project was completed by using the BMAD-METHOD (Breakthrough Method of Agile Ai-Driven Development).
The core architecture and proposed tools are outlined in the High-Level Architecture Document.
You can also use
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Prerequisites
- Python >= 3.10
- uv (Python package and environment manager) for developers
Installation From Source (for developers)
-
Clone the repository:
git clone https://github.com/ksylvan/fabric-mcp.git cd fabric-mcp
-
Install dependencies using uv sync:
uv sync --dev
This command ensures your virtual environment matches the dependencies in
pyproject.tomlanduv.lock, creating the environment on the first run if necessary. -
Activate the virtual environment (uv will create it if needed):
-
On macOS/Linux:
source .venv/bin/activate
-
On Windows:
.venv\Scripts\activate
-
Now you have the development environment set up!
Installation From PyPI (for users)
If you just want to use the fabric-mcp server without developing it, you can install it directly from PyPI:
# Using pip
pip install fabric-mcp
# Or using uv
uv pip install fabric-mcp
This will install the package and its dependencies. You can then run the server using the fabric-mcp command.
Configuration (Environment Variables)
The fabric-mcp server can be configured using the following environment variables:
FABRIC_BASE_URL: The base URL of the running Fabric REST API server (fabric --serve).- Default:
http://127.0.0.1:8080
- Default:
FABRIC_API_KEY: The API key required to authenticate with the Fabric REST API server, if it's configured to require one.- Default: None (Authentication is not attempted if not set).
FABRIC_MCP_LOG_LEVEL: Sets the logging verbosity for thefabric-mcpserver itself.- Options:
DEBUG,INFO,WARNING,ERROR,CRITICAL(case-insensitive). - Default:
INFO
- Options:
You can set these variables in your shell environment (or put them into a .env file in the working directory) before running fabric-mcp:
export FABRIC_BASE_URL="http://your-fabric-host:port"
# This must match the key used by fabric --serve
export FABRIC_API_KEY="your_secret_api_key"
export FABRIC_MCP_LOG_LEVEL="DEBUG"
# Standard I/O transport (default)
fabric-mcp --stdio
# HTTP Streamable transport for HTTP-based MCP clients
fabric-mcp --http-streamable
# Custom host/port for HTTP transport
fabric-mcp --http-streamable --host 0.0.0.0 --port 3000 --mcp-path /message
Transport Options
The fabric-mcp server supports multiple transport methods:
--stdio: Standard I/O transport for direct MCP client integration (default)--http-streamable: HTTP-based transport that runs a full HTTP server for MCP communication--host: Server bind address (default: 127.0.0.1)--port: Server port (default: 8000)--mcp-path: MCP endpoint path (default: /message)
For more details on transport configuration, see the Infrastructure and Deployment Overview.
Contributing
Read the contribution document here and please follow the guidelines for this repository.
Also refer to the cheat-sheet for contributors which contains a micro-summary of the development workflow.
License
Copyright (c) 2025, Kayvan Sylvan Licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for fabric-mcp 1.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fabric_mcp-1.2.5.tar.gz | 787.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fabric_mcp-1.2.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 812.9 kB
Release files / fabric_mcp-1.2.5.tar.gz
| Download URL | fabric_mcp-1.2.5.tar.gz |
|---|---|
| Size | 787.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
489c023106c2610972285b8fbdad68c8026a2f4a024c2fa57299d044a7d7c010
|
|
BLAKE2b-256 checksum How to use checksums |
70557b310083193a526bc4e8668cb760bae756f1106ec965fc639dcd517575b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / fabric_mcp-1.2.5-py3-none-any.whl
| Download URL | fabric_mcp-1.2.5-py3-none-any.whl |
|---|---|
| Size | 25.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64ecf8c897b80ab9cbb1aeacbfcc2afc2851f3ed0f49f2fb0b658b0fa61cabfe
|
|
BLAKE2b-256 checksum How to use checksums |
6cff14e1e6f5750940d947f0fd1ded12a567581b7406806091807e9dc8c8a7d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
