AI导哈

提示词收集分析工具

一个用于记录、分析和改进Claude Desktop提示词的工具，帮助提升提示工程技能，提供质量评分、智能建议和进度跟踪功能。

  • by daneb
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 daneb/improver-mcp

使用说明

MCP提示收集器

一个MCP服务器，提供用于记录、分析和改进Claude Desktop提示的交互式工具，以帮助您培养更好的提示工程技能。

安装

选项1:NPM包（推荐）

# Install globally
npm install -g mcp-prompt-collector

# Or install locally in your project
npm install mcp-prompt-collector

选项2：来源

git clone https://github.com/daneb/improver-mcp.git
cd improver-mcp
npm install
npm run build

设置

  1. 配置Claude桌面

    将此添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:

    对于全局npm安装：

    {
  "mcpServers": {
    "mcp-prompt-collector": {
      "command": "mcp-prompt-collector",
      "env": {
        "HOME": "/Users/daneb"
      }
    }
  }
}

    对于源安装：

    {
  "mcpServers": {
    "mcp-prompt-collector": {
      "command": "/path/to/your/node",
      "args": ["/path/to/improver-mcp/dist/index.js"],
      "env": {
        "HOME": "/Users/daneb"
      }
    }
  }
}

  2. 重新启动克劳德桌面 加载MCP服务器

  3. 访问仪表板 在http://localhost:3456

它做什么

  • 🛠️ 交互式工具：提供4个可在Claude Desktop中访问的工具，用于快速分析
  • 📊 质量分析：对结构、清晰度、上下文和有效性进行评分
  • 💡 智能洞察：识别模式并提出具体改进建议
  • 📈 进度跟踪：显示质量趋势和随时间的改进
  • 🌐 Web仪表板：干净的界面，可查看历史记录、分析和见解

特性

核心功能

  • ✅ 用于Claude Desktop集成的交互式MCP工具
  • ✅ 用于本地存储的SQLite数据库（无云同步）
  • ✅ 实时即时质量评分
  • ✅ 带分析功能的Web仪表板
  • ✅ 自动生成见解

可用工具

  • log_prompt -记录并分析带有即时质量反馈的提示
  • improve_prompt -获取改进任何提示的具体建议
  • get_prompt_insights -从提示历史中查看分析和模式
  • view_stats -显示全面的统计数据和质量趋势

分析引擎

  • 质量评分：根据结构、清晰度和完整性得0-10分
  • 复杂性检测：将提示分为简单、中等或复杂
  • 技术建议：推荐最佳提示技巧
  • 问题检测：识别歧义、上下文缺失、偏见等。

仪表板功能

  • 具有搜索和过滤功能的提示历史记录
  • 随时间变化的质量趋势
  • 复杂性分布图
  • 近期活动概述
  • 可操作的改进见解

用法

在克劳德桌面

MCP服务器运行后，您将可以在Claude Desktop中访问这些工具：

log_prompt
- Use: Log and analyze any prompt
- Example: "log_prompt" with your prompt text
- Returns: Quality score, complexity, and improvement suggestions

improve_prompt  
- Use: Get specific suggestions for a prompt
- Example: "improve_prompt" with your prompt and optional goal
- Returns: Detailed analysis and actionable improvement recommendations

get_prompt_insights
- Use: View patterns and insights from your prompt history
- Example: "get_prompt_insights" optionally filtered by category
- Returns: Analytics on your prompting patterns and common issues

view_stats
- Use: See comprehensive statistics and trends
- Example: "view_stats" for last 30 days (configurable)
- Returns: Total prompts, quality trends, complexity breakdown

开发命令

# Build and run
npm run build                       # Build TypeScript
npm run dev                         # Development mode with auto-reload
npm start                          # Start the MCP server

# Code quality
npm test                           # Run tests
npm run lint                       # Check code style
npm run format                     # Format code

运作原理

  1. MCP集成：在Claude Desktop注册为MCP服务器
  2. 交互式工具：提供4个可通过Claude Desktop界面访问的工具
  3. 手动记录：用户使用 log_prompt 工具
  4. 分析：对质量进行评分，检测模式，识别改进
  5. 存储：将所有内容保存在SQLite数据库中
  6. 洞察：根据您的模式生成个性化建议
  7. 仪表盘：提供web界面以查看分析和历史记录

配置

默认配置存储在 ~/.mcp-prompt-collector/config/settings.json:

{
  "name": "mcp-prompt-collector",
  "capabilities": {
    "intercept": true,
    "modify": false,
    "store": true
  },
  "settings": {
    "enhancePrompts": false,
    "storageLocation": "~/.mcp-prompt-collector/data",
    "dashboardPort": 3456,
    "analysisLevel": "detailed",
    "retentionDays": 90
  }
}

数据存储

所有数据都存储在SQLite数据库中：

  • 位置: ~/.mcp-prompt-collector/data/prompt_history.db
  • 隐私：无云同步，完全本地控制
  • 保留：N天后可配置的清理
  • 出口：完整的数据导出功能

发展

# Clone and setup
git clone <repo-url>
cd mcp-prompt-collector
npm install

# Development workflow
npm run dev        # Watch mode
npm run build      # Production build
npm test          # Run tests
npm run lint      # Code quality

# Testing
npm run test:unit        # Unit tests
npm run test:integration # Integration tests

建筑

  • MCP协议处理程序：与Claude Desktop通信
  • 存储管理器：SQLite数据库操作
  • 分析引擎：快速的质量评分和见解
  • 仪表板服务器：Express.js web界面
  • 后台工作人员：计划分析和清理

隐私和安全

  • ✅ 仅限本地：所有数据都保留在您的机器上
  • ✅ 无云同步：零外部数据传输
  • ✅ 用户控件：完成数据所有权和导出
  • ✅ 透明：开源、可审计的代码

需求

  • Node.js: 18+
  • 克劳德桌面：支持MCP的最新版本
  • macOS：主要支持（Windows/Linux即将推出）

故障排除

服务器无法启动

  • 检查端口3456是否可用
  • 验证克劳德桌面MCP配置
  • 跑 mcp-prompt-collector status 用于诊断

仪表板上没有显示提示

  • 确保您正在使用 log_prompt Claude Desktop中的工具
  • 提示不会自动捕获-您必须手动记录它们
  • 检查Claude Desktop中的MCP服务器工具是否可用

仪表板未加载

  • 检查服务器是否在正确的端口上运行
  • 尝试使用不同的端口 setup --port 3457
  • 检查浏览器控制台是否有错误

许可证

MIT许可证-有关详细信息，请参阅许可证文件

相关 MCP