MCP Playbook Server

MCPOpen Source29.2

by dwarvesf • Documentation & Docs

A Model Context Protocol server that helps LLM agents manage and synthesize project documentation and save/upload conversation logs into a user-specified project directory and related GitHub repositories.

Example Use Cases

1
Create, update, or overwrite project documentation files (ADRs, specs, changelogs, runbook) inside a target project directory.
2
Capture conversation history, save it locally in a .chat/ folder, and upload it to a central GitHub prompt-log repository for audit or sharing.
3
Search and pull content from the dwarvesf/runbook and dwarvesf/prompt-db repositories, and propose or open PRs to update the runbook.

Description

This MCP server exposes a set of tools for creating and updating project docs (ADRs, specs, changelogs, runbooks), searching external runbook/prompt repos, and saving/uploading chat histories. It operates on a target_project_dir on disk, performs filesystem operations, and integrates with specific dwarvesf GitHub repositories for syncing prompts and uploading logs. The server is intended to be used by MCP-capable clients (e.g., Claude Desktop) to let LLMs programmatically manage local project documentation and partially replicate docs and chat logs to GitHub.

Capabilities(12 total)

Tools (11)

init_playbook

Provides an instruction to the LLM about the purpose of the mcp-playbook server, which is to facilitate local project documentation and enable partial replication of documentation and chat logs for an AI-powered playbook.

create_spec

Creates or overwrites a new specification file (e.g., PRD, RFC, architectural planning) in the docs/specs/ directory of the target project. Specification files will be named following a `spec-name.md` convention. For small feature changes, a simple markdown outline is sufficient. For larger or more complex changes, format the content as a formal PRD or RFC.

target_project_dir:string*spec_name:string*content:string*

create_adr

Creates or overwrites a new Architectural Decision Record (ADR) file in the docs/adr/ directory of the target project. ADR files will be named following an `adr-name.md` convention.

target_project_dir:string*adr_name:string*content:string*

create_changelog

Creates a new, detailed, and user-facing changelog entry file in the docs/changelog/ directory of the target project. Each changelog entry will be a separate file named following a `changelog-entry.md` convention. Entries should provide comprehensive information about changes, including how to use new features or any impact on existing functionality, rather than being brief summaries.

target_project_dir:string*entry_content:string*changelog_name:string*

save_and_upload_chat_log

Captures the current conversation history, saves it as a markdown file in the .chat/ directory of the target project, and uploads it to the dwarvesf/prompt-log GitHub repository. Requires a user ID to organize logs by user.

target_project_dir:string*userId:string*editorType:string*

Prompts (1)

init-playbook

Provides the initial instruction prompt for the MCP Playbook server.

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

D47/100

4/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities11 Tools / 1 Prompts / 0 Resources

Ownerdwarvesf

CategoryDocumentation & Docs

DependenciesStandalone

Set Your Username