编剧MCP
一种模型上下文协议（MCP）服务器，用于管理创意写作项目中的角色知识和关系。
特性
- 具有丰富描述和元数据的字符管理
- 具有语义搜索功能的知识事实存储
- 角色关系跟踪与分析
- 基于人工智能的标签生成和关系分析
- 语义搜索的向量嵌入
- 带连接池的PostgreSQL后端
安装
# Clone the repository
git clone
cd writer-mcp
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -e .配置
复制 .env.example 向 .env 并配置您的设置：
cp .env.example .env编辑 .env 使用您的数据库和API凭据：
# 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用法
启动服务器
# 初始化数据库（首次运行）
python scripts/init_db.py
# 启动MCP服务器
python run_server.py可用工具
- create_character - 创建新角色
- 搜索字符 - 搜索角色
- add_character_fact - 添加角色事实
- 搜索行为 - 搜索事实
- 生成字符标签 - 生成角色标签
- 分析特征关系 - 分析角色关系
发展
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Start development server
python scripts/dev_server.py项目结构
writer-mcp/
├── src/writer_mcp/ # 主要源代码
│ ├── config.py # 配置管理
│ ├── server.py # MCP服务器
│ ├── database/ # 数据库相关
│ ├── schemas/ # 数据模型
│ ├── services/ # 业务逻辑
│ ├── tools/ # MCP工具定义
│ └── utils/ # 工具函数
├── scripts/ # 脚本文件
├── tests/ # 测试文件
├── run_server.py # 服务器启动脚本
└── main.py # 主入口文件许可证
MIT许可证-有关详细信息，请参阅许可证文件。