Skip to main content
Glama

Writer MCP

by huangjien
MIT License

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

可用工具

  1. create_character - 创建新角色
  2. search_characters - 搜索角色
  3. add_character_fact - 添加角色事实
  4. search_facts - 搜索事实
  5. generate_character_tags - 生成角色标签
  6. 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server that manages character knowledge and relationships for creative writing projects, offering semantic search and AI-powered analysis.

  1. Features
    1. Installation
      1. Configuration
        1. Usage
          1. 启动服务器
          2. 可用工具
        2. Development
          1. Project Structure
            1. License

              Related MCP Servers

              • 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 -
                84
                40
                Python
                MIT License
                • Linux
                • Apple
              • A
                security
                A
                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
                19
                Python
                MIT License
              • 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
                JavaScript
                MIT License
              • -
                security
                F
                license
                -
                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 -
                TypeScript

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/huangjien/writer-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server