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

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

License

MIT License - see LICENSE file for details.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Related MCP Servers

Appwrite MCP Serverofficial
appwrite
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
Last updated -
54
MIT License
MCP Outline Server
Vortiago
A
security
-
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Last updated -
25
57
MIT License
Storybook MCP Server
m-yoshiro
A
security
A
license
A
quality
A Model Context Protocol server that integrates with Storybook to help AI tools query UI components and retrieve usage examples from static Storybook files.
Last updated -
2
462
21
MIT License
Better Fetch
flutterninja9
A
security
F
license
A
quality
A Model Context Protocol server that intelligently fetches and processes web content, transforming websites and documentation into clean, structured markdown with nested URL crawling capabilities.
Last updated -
2
21
5

View all related MCP servers

Appeared in Searches

A server for finding creative writing resources and content

Writer MCP

Writer MCP

Features

Installation

Configuration

Usage

启动服务器

可用工具

Development

Project Structure

License

Related Resources

Related MCP Servers

Appwrite MCP Serverofficial

MCP Outline Server

Storybook MCP Server

Better Fetch

Appeared in Searches

New MCP Servers

MCP directory API