stevebrownlee/book-mcp-server

Book MCP Server - Tool Reference

This MCP server provides comprehensive manuscript analysis and content access tools for book writing projects. It supports markdown files and offers both basic text analysis and advanced NLP-powered features for authors, editors, and writing professionals.

Server Overview

• Name: Book MCP Server
• Purpose: Comprehensive manuscript analysis and content access for book writing
• Supported Files: Markdown (.md) files
• Total Tools: 25 tools across 6 categories

Tool Categories

1. Statistical Analysis Tools - Tools that provide statistical insights about your book project

Tool	Description	Usage
	List all chapter files with enhanced metadata including titles and word counts	"Show me all my chapters with their word counts"
	Get overall statistics about the entire book project	"What are my overall book statistics?"
	Analyze chapter length consistency and distribution	"Are my chapters consistently sized?"
	Analyze word frequency across all chapters	"What are my most frequently used words?"
	Analyze story structure, pacing, and narrative elements across all chapters	"How is my story structured across chapters?"

2. Content Access Tools - Tools for reading and searching specific content within your manuscript

Tool	Description	Usage
	List all markdown files in the book directory	"What files are in my book project?"
	Read the complete content of a specific markdown file	"Read Chapter 5 for me"
	Search for specific text across all markdown files	"Search for all mentions of 'dragon' in my book"
	Get a preview and basic stats of a markdown file	"Give me a summary of Chapter 3"

3. Advanced NLP Analysis Tools - AI-powered analysis using advanced Natural Language Processing libraries

Tool	Description	Usage
	Automatically discover all character names using advanced NLP	"Who are all the characters in my book?"
	Quickly identify characters that appear infrequently and may need development	"Which characters in my book need more development?"
	Analyze which characters appear together in scenes and chapters	"Which characters interact most frequently?"
	Calculate professional readability metrics (Flesch-Kincaid, Gunning Fog, etc.)	"Is Chapter 5 too complex for my target audience?"
	Professional-level grammar and style checking	"What grammar errors are in Chapter 2?"

4. Semantic Search Tools (ChromaDB Integration) - Vector-based semantic search using ChromaDB for meaning-based content discovery

Tool	Description	Usage
	Connect to ChromaDB and list available collections	"What collections are available in my vector database?"
	Search content using natural language queries and vector similarity	"Find all content about character development"
	Discover content related to specific themes or concepts	"Find all content related to the theme of redemption"
	Use vector similarity to find character relationships beyond co-occurrence	"How does Sarah relate to other characters emotionally?"
	Find potentially contradictory information about plot elements	"Check consistency of the magic system throughout my book"
	Combine semantic and exact search for comprehensive character analysis	"Give me a complete analysis of my protagonist"

5. Editorial Feedback Tools - Tools that provide actionable editorial feedback for improving your manuscript

Tool	Description	Usage
	Identify specific writing problems in a chapter	"What writing issues are in Chapter 2?"
	Check character descriptions and traits across all chapters	"Check if Sarah is consistently described throughout my book"
	Analyze balance between showing (scenes) vs telling (summary)	"Is Chapter 4 too heavy on exposition?"

6. Utility Tools - General utility methods for server information and functionality

Tool	Description	Usage
	Show all available methods with descriptions and usage examples	"What methods can I use?"

Configuration

Environment Variables

• BOOK_DIRECTORY: Directory containing your markdown files (default: current directory)
• CHROMA_PERSIST_DIR: ChromaDB database path (default: "./chroma_db")
• RETRIEVAL_K: Number of results for semantic search (default: 4)
• EMBEDDING_MODEL: Embedding model for ChromaDB (default: "mistral")

Dependencies

• Core: Python 3.7+, FastMCP
• NLP Features: spaCy (pipenv install spacy && python -m spacy download en_core_web_sm)
• Readability: textstat (pipenv install textstat)
• Grammar: language-tool-python (pipenv install language-tool-python)
• Semantic Search: ChromaDB (pipenv install chromadb)

Usage Tips

1. Start with to see your book structure
2. Use to find character mentions or themes
3. Run on chapters you're revising
4. Check for main characters
5. Use to improve scene writing
6. Get for overall progress tracking

Example Workflows

Chapter Revision Workflow

1. - Read current version
2. - Find prose problems
3. - Check scene balance
4. Revise based on feedback

Character Development Check

1. - Complete character analysis
2. - Semantic relationships
3. - Check consistency
4. Update character development based on insights

Thematic Analysis

1. - Check ChromaDB connection
2. - Explore love theme
3. - Explore conflict theme
4. - Find development arcs
5. Strengthen weak thematic areas

Plot Consistency Check

1. - Check world-building
2. - Check chronology
3. - Find constraint mentions
4. Fix any inconsistencies found

Book Structure Analysis

1. - Overall project status
2. - Check pacing
3. - Analyze story flow
4. - Find story peaks
5. Adjust structure based on insights

---

This documentation covers all 25 tools available in the Book MCP Server. For the most up-to-date information, refer to the source code in .