MCP Playbook Server
@dwarvesf
基本情報
MCP Playbook Server について
A Model Context Protocol (MCP) server for managing project documentation and saving conversation logs within a user-specified target project directory.
MCP Playbook Server の設定
以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。
{
"mcpServers": {
"mcp-playbook": {
"command": "npx",
"args": [
"-y",
"@dwarvesf/mcp-playbook@latest"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
}
}
}
}MCP Playbook Server のツール
11Provides 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.
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.
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.
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.
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.
Fuzzy search for keywords in the dwarvesf/runbook GitHub repository.
Fuzzy search for keywords in the dwarvesf/prompt-db GitHub repository (excluding the synced_prompts/ folder).
Creates or updates a Pull Request in the dwarvesf/runbook repository with a new runbook entry.
Syncs an LLM prompt to the dwarvesf/prompt-db GitHub repository in YAML format.
Use the tool to think about something. It will not obtain new information or make any changes to the repository, but just log the thought. Use it when complex reasoning or brainstorming is needed. For example, if you explore the repo and discover the source of a bug, call this tool to brainstorm several unique ways of fixing the bug, and assess which change(s) are likely to be simplest and most effective. Alternatively, if you receive some test results, call this tool to brainstorm ways to fix the failing tests.
Use this tool to append content to the central 'Project Runbook' file located at `docs/runbook.md` within the `target_project_dir`. **Before calling this tool, you MUST:** 1. Thoroughly analyze all relevant project documents (ADRs, specs, changelogs, code, etc.) within the `target_project_dir`. 2. If `docs/runbook.md` already exists, **you MUST review its current content** as part of your analysis to avoid duplicating information. 3. Synthesize all gathered information into new, additive content for the Project Runbook. This runbook serves as the primary, evolving knowledge base for understanding feature flows, key components, interactions, and operational procedures. 4. The `content` you provide to this tool **must be new content to be appended** to the existing `docs/runbook.md` file. **IMPORTANT:** This tool *only appends* content. If you need to perform significant rewrites, corrections, or manual edits to the `docs/runbook.md` file, you should use `commander-edit_block` for surgical changes or `commander-write_file` with `mode: 'rewrite'` if a complete overhaul is necessary. The frontmatter of the runbook will be automatically updated with the current date and any source references you provide.
概要
What is MCP Playbook Server?
A Model Context Protocol (MCP) server that helps LLMs manage project documentation and save conversation logs within a user‑specified target project directory. It is a self-contained Node.js/TypeScript application designed for teams using AI‑assisted development workflows.
How to use MCP Playbook Server?
Configure the server in your MCP client (e.g., Claude Desktop) by adding an entry with npx -y @dwarvesf/mcp-playbook@latest and your GitHub Personal Access Token. Include the rule “ALWAYS run the init_playbook tool before starting” in your cursor, cline, or windsurf rules.
Key features of MCP Playbook Server?
- Initializes playbook instructions for LLM context.
- Creates specification, ADR, and changelog files.
- Distills project runbook from existing documents.
- Saves and uploads conversation logs to GitHub.
- Searches runbook and prompt databases.
Use cases of MCP Playbook Server?
- Structuring project documentation with LLM assistance.
- Recording architectural decisions (ADRs) during development
「その他」の他のコンテンツ
Volley.sh
VolleyA good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Hindsight
vectorize-ioHindsight: Agent Memory That Learns
Handl
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
コメント