rlryals/book-series-mcp

本页由 AI 翻译，技术细节请以原文为准。查看原文

3 stars 5 forks 质量 65 趋势 10MIT

This project provides a set of Model Context Protocol (MCP) servers designed to help manage complex book series writing projects with Claude Desktop.

概览

This project provides a set of Model Context Protocol (MCP) servers designed to help manage complex book series writing projects with Claude Desktop. It includes functionality for character management, plot tracking, world-building, research/continuity tracking, and writing production management. - Character Management & Development Tracking - Plot Structure & Timeline Management - World-Building & Location Tracking - Research & Continuity Management - Writing Production & Progress Tracking - Automated Story Structure Validation - Character Knowledge State Tracking - Text-to-Speech Generation with ElevenLabs Integration - Node.js (v16 or higher) - Docker (recommended) OR PostgreSQL (v12 or higher) - Claude Desktop Then edit .env with your desired configuration. 1.

README

以下为原文 README 节选，完整内容请查看原文。

Book Series MCP (Model Context Protocol) Server

Features

Character Management & Development Tracking
Plot Structure & Timeline Management
World-Building & Location Tracking
Research & Continuity Management
Writing Production & Progress Tracking
Automated Story Structure Validation
Character Knowledge State Tracking
Text-to-Speech Generation with ElevenLabs Integration

Prerequisites

Node.js (v16 or higher)
Docker (recommended) OR PostgreSQL (v12 or higher)
Claude Desktop

Quick Start

Clone the repository

git clone https://github.com/RLRyals/book-series-mcp.git
cd book-series-mcp

Set up environment variables

cp .env.template .env

Then edit .env with your desired configuration.

Install dependencies

npm install

Set up the database

You have two options:

Option A: Using Docker (Recommended)

Install Docker:
- Visit Docker Desktop’s download page
- Download Docker Desktop for Windows
- Run the installer and follow the installation wizard
- During installation:
  - If prompted about WSL 2, allow Docker to install it
  - Accept the default settings
- Restart your computer after installation
Start Docker:
- Launch Docker Desktop from your Start menu
- Wait for the Docker icon in your system tray to stop animating (this means Docker is ready)
- You can verify Docker is running by:
  - Right-clicking the Docker icon in the system tray
  - It should say “Docker Desktop is running” with a green check mark
Run the database setup script:

pwsh .\db-docker-tools.ps1 -setup

This will:

Create a Docker container with PostgreSQL
Initialize the database with the schema
Set up all necessary tables and views

Additional Docker database management commands:

# Check database status
pwsh .\db-docker-tools.ps1 -Command status

# Connect to database directly
pwsh .\db-docker-tools.ps1 -Command connect

# Backup the database
pwsh .\db-docker-tools.ps1 -Command backup

# Test connection
pwsh .\db-docker-tools.ps1 -Command test-connection

# Run specific migration
pwsh .\db-docker-tools.ps1 -Command run-migration -MigrationFile

You can customize the Docker setup using these environment variables in your .env file:

POSTGRES_DOCKER_CONTAINER=book-series-db
POSTGRES_DOCKER_PORT=5432
POSTGRES_DOCKER_PASSWORD=your_docker_password_here

Option B: Using existing PostgreSQL installation

(This option doesn’t require Docker or any Docker-related files)

Create a new database in your PostgreSQL instance:

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "writing-production": {
      "command": "node",
      "args": ["path/to/book-series-mcp/src/writing-server/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DATABASE_URL": "postgresql://writer:secure_writing_password_2025@localhost:5432/book_series"
      }
    },
    "character-development": {
      "command": "node",
      "args": ["path/to/book-series-mcp/src/character-server/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DATABASE_URL": "postgresql://writer:secure_writing_password_2025@localhost:5432/book_series"
      }
    },
    "plot-management": {
      "command": "node",
      "args": ["path/to/book-series-mcp/src/plot-server/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DATABASE_URL": "postgresql://writer:secure_writing_password_2025@localhost:5432/book_series"
      }
    },
    "world-building": {
      "command": "node",
      "args": ["path/to/book-series-mcp/src/world-server/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DATABASE_URL": "postgresql://writer:secure_writing_password_2025@localhost:5432/book_series"
      }
    },
    "research-continuity": {
      "command": "node",
      "args": ["path/to/book-series-mcp/src/research-server/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DATABASE_URL": "postgresql://writer:secure_writing_password_2025@localhost:5432/book_series"
      }
    },
    "book-series-manager": {
 
…