MCP 服务器

Writer MCP

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

README

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