promptflow-mcp

<p align="center"> <img src="assets/logo.svg" width="120" alt="promptflow-mcp logo" /> </p>

<h1 align="center">promptflow-mcp</h1>

<p align="center"> <b>A Model Context Protocol server for prompt template management.</b><br /> Store, version, search and render prompts — for AI agents and CLI users alike. </p>

<p align="center"> <a href="https://www.npmjs.com/package/@modelcontextprotocol/sdk"><img alt="MCP SDK" src="https://img.shields.io/badge/MCP-SDK-blue" /></a> <a href="https://www.typescriptlang.org/"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.4-3178c6" /></a> <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/License-MIT-green" /></a> <img alt="Node >= 18" src="https://img.shields.io/badge/Node-%3E%3D18-339933" /> <img alt="Version" src="https://img.shields.io/badge/version-0.2.1-orange" /> </p>

---

✨ Features

• 📚 Template registry — save prompts with variables ({{input}})
• 🕘 Versioning — every edit creates a new version; nothing is lost
• 🔍 Search — full-text search across name, body and tags
• 🧩 Rendering — interpolate {{variables}} at call time
• 💾 Local-first — plain JSON on disk; back up or sync with git
• 🔌 MCP native — works with any MCP client (Claude, Cursor, etc.)

<p align="center"> <img src="assets/demo.gif" alt="demo" width="640" /> </p>

🚀 Quick start

# clone, install, build
git clone https://github.com/DuxuteLi70/promptflow-mcp.git
cd promptflow-mcp
npm install
npm run build

# run the tests
npm test

# start the MCP server
node dist/index.js

🛠 MCP tools

Tool	Description
prompt.save	Save or update a prompt template
prompt.list	List all templates (title, version, tags)
prompt.get	Get a template, rendered with variables
prompt.search	Full-text search
prompt.delete	Remove a template
prompt.versions	Show version history of a template

💡 Example

import { TemplateRegistry } from "./src/storage/store.js";

const reg = new TemplateRegistry();

// save a template
const id = reg.save("code-review", "Review this diff:\n{{diff}}", ["review"]);

// render it with variables
const rendered = reg.render(id, { diff: "..." });

// every save keeps history
reg.update(id, "Review this carefully:\n{{diff}}");
reg.versions(id); // [{version: 1, ...}, {version: 2, ...}]

📦 Project layout

promptflow-mcp/
├── src/
│   ├── index.ts            # entry point
│   ├── server.ts           # MCP server wiring
│   ├── tools/              # MCP tool definitions
│   └── storage/            # JSON-file template store
├── tests/                  # unit tests (node:test)
├── docs/                   # design & usage docs
├── examples/               # MCP client config examples
└── assets/                 # logo + demo media

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

📄 License

MIT