Which integrations are available for this server?

Uses OpenAI models for AI-powered tag generation, relationship analysis, and semantic search capabilities through configurable model selection for both chat and embeddings. Stores character data, knowledge facts, and relationship information with connection pooling and vector embeddings support for semantic search functionality.

How do I use Writer MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Writer MCP search for characters related to 'mage' in my fantasy novel" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Writer MCP

A Model Context Protocol (MCP) server for managing character knowledge and relationships in creative writing projects.

Features

Character management with rich descriptions and metadata
Knowledge facts storage with semantic search capabilities
Character relationship tracking and analysis
AI-powered tag generation and relationship analysis
Vector embeddings for semantic search
PostgreSQL backend with connection pooling

Related MCP server: MCP Outline Server

Installation

# Clone the repository
git clone <repository-url>
cd writer-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e .

Configuration

Copy .env.example to .env and configure your settings:

cp .env.example .env

Edit .env with your database and API credentials:

# Database Configuration
DATABASE_URL=postgresql://username:password@localhost:5432/writer_mcp
TEST_DATABASE_URL=postgresql://username:password@localhost:5432/writer_mcp_test

# OpenAI Configuration
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_BASE_URL=https://api.openai.com/v1
CHAT_MODEL=gpt-4o-mini
EMBEDDING_MODEL=text-embedding-3-small

# Application Configuration
APP_NAME=Writer MCP
DEBUG_MODE=true

# Vector Configuration
VECTOR_DIMENSION=1536

# Search Configuration
DEFAULT_SEARCH_LIMIT=10
MAX_SEARCH_LIMIT=100

# MCP Server Configuration
MCP_SERVER_NAME=writer-mcp
MCP_SERVER_VERSION=1.0.0

Usage

启动服务器

# 初始化数据库（首次运行）
python scripts/init_db.py

# 启动MCP服务器
python run_server.py

可用工具

create_character - 创建新角色
search_characters - 搜索角色
add_character_fact - 添加角色事实
search_facts - 搜索事实
generate_character_tags - 生成角色标签
analyze_character_relationships - 分析角色关系

Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Start development server
python scripts/dev_server.py

Project Structure

writer-mcp/
├── src/writer_mcp/          # 主要源代码
│   ├── config.py            # 配置管理
│   ├── server.py            # MCP服务器
│   ├── database/            # 数据库相关
│   ├── schemas/             # 数据模型
│   ├── services/            # 业务逻辑
│   ├── tools/               # MCP工具定义
│   └── utils/               # 工具函数
├── scripts/                 # 脚本文件
├── tests/                   # 测试文件
├── run_server.py            # 服务器启动脚本
└── main.py                  # 主入口文件