Which integrations are available for this server?

Uses [OpenAI](/mcp/servers/integrations/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.

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 # 主入口文件