Story Goal MCP

故事目标MCP服务器

LXD MCP套件的一部分——一组用于学习体验设计（指导、看板、故事和可选的LLM适配器）的MCP服务器。

它是什么

故事/目标MCP服务器，跟踪结果（目标）和用户故事，包括阶段和进度说明。

为什么它有帮助

持续关注可交付成果和随时间推移的进展；补充了看板的计划和执行。

一个轻量级的MCP服务器，用以结果为中心的用户故事和目标取代以任务为中心的待办事项列表。跟踪用户价值的有意义进展，而不仅仅是检查任务。

🎯 哲学

而不是： “编写身份验证测试”\ 思考： “作为用户，我可以安全登录，从而保护我的数据”

故事具有完整的背景，并与更大的目标联系在一起，使发展更加有目的和以结果为导向。

🚀 快速开始

安装

git clone 
cd story-goal-mcp

没有依赖关系！使用Python内置的SQLite。

基本用法

# 1. Register as a user (creates isolated workspace)
python3 story_goal_mcp.py handshake your-username "Your Name"

# 2. Create a goal (high-level outcome)
python3 story_goal_mcp.py create-goal your-username \
  "Build User Authentication" \
  "Secure user login/logout with session management" \
  "Users can safely access protected features"

# 3. Create stories toward that goal
python3 story_goal_mcp.py create-story your-username \
  "Secure Login Form" \
  "As a user" \
  "I want to log in with email/password" \
  "So that I can access my personal data"

# 4. View your progress
python3 story_goal_mcp.py list-goals your-username
python3 story_goal_mcp.py list-stories your-username

安装（本地PATH）

bash scripts/install_local.sh
export PATH="$HOME/.local/bin:$PATH"   # add to shell profile for persistence

# Start MCP server from anywhere
story-goal-mcp

登录时运行

macOS（launchd）：

bash scripts/install_service_macos.sh
# Logs:
tail -f "$HOME/Library/Logs/story-goal-mcp.out" "$HOME/Library/Logs/story-goal-mcp.err"

Linux（systemd用户）：

bash scripts/install_service_systemd.sh
systemctl --user status story-goal-mcp.service
journalctl --user -u story-goal-mcp.service -f

📋 命令

用户管理

# Register/check user state
python3 story_goal_mcp.py handshake  [name]

目标管理

# Create a goal
python3 story_goal_mcp.py create-goal    [success_metrics]

# List all goals with story counts
python3 story_goal_mcp.py list-goals 

故事管理

# Create a story
python3 story_goal_mcp.py create-story      [goal_id]

# List stories (all, by goal, or by phase)
python3 story_goal_mcp.py list-stories  [goal_id] [phase]

# Update story progress (TODO: implement)
python3 story_goal_mcp.py update-story   
 

🏗️ 数据结构

目标

{
  "id": "c420c3ad",
  "title": "Build User Authentication",
  "vision": "Secure login system with session management",
  "success_metrics": "Users can safely access protected features",
  "total_stories": 3,
  "completed_stories": 1,
  "created_at": "2025-09-08T19:18:20.682533"
}

用户故事

{
  "id": "33bbaf8b",
  "title": "Secure Login Form",
  "as_a": "As a user",
  "i_want": "I want to log in with email/password",
  "so_that": "So that I can access my personal data",
  "current_phase": "defining",
  "acceptance_criteria": ["Form validates email format", "Password is hashed"],
  "progress_notes": [
    {
      "timestamp": "2025-09-08T19:20:15.123456",
      "phase": "developing",
      "notes": "Started implementing form validation"
    }
  ],
  "goal_id": "c420c3ad"
}

📈 故事阶段

1. 定义 -编写验收标准，了解要求
2. 开发中 -构建、编码、实施
3. 验证 -测试、审查、获取反馈
4. 完成 -故事为用户带来价值

🔒 用户分离

每个用户都会获得完全隔离的数据：

# User A's workspace
python3 story_goal_mcp.py handshake alice "Alice Smith"
python3 story_goal_mcp.py create-goal alice "Build Chat App" "..."

# User B's workspace (completely separate)  
python3 story_goal_mcp.py handshake bob "Bob Jones"
python3 story_goal_mcp.py create-goal bob "E-commerce Site" "..."

数据存储在SQLite中，用户密钥分离，确保隐私。

💡 使用模式

1.冲刺计划

# Create goal for the sprint
python3 story_goal_mcp.py create-goal alice \
  "Sprint 1: Core Features" \
  "MVP with essential user flows working" \
  "Users can complete primary workflows"

# Break into stories
python3 story_goal_mcp.py create-story alice \
  "User Registration" "As a new user" "I want to create account" "So that I can use the app"

python3 story_goal_mcp.py create-story alice \
  "Dashboard View" "As a user" "I want to see my data" "So that I can track progress"

2.功能开发

# Create focused goal
python3 story_goal_mcp.py create-goal dev123 \
  "Search Functionality" \
  "Fast, accurate search across all content" \
  "Users find what they need in  仅供内部使用-未获得外部分发或托管许可。