智能提示MCP服务器
一个增强的MCP（模型上下文协议）服务器，通过智能发现、组合和管理功能从GitHub存储库中获取提示。这是一个增强的fork 提示mcp服务器 与GitHub集成和高级功能。
🌟 主要特点
核心能力
- 🔄 GitHub集成：直接从GitHub存储库（公共/私有）获取提示
- 🔍 智能发现：使用类别和标签过滤的高级搜索
- 🔗 快速构图：将多个提示合并到工作流中
- 📊 使用情况跟踪：即时使用模式分析
- ⚡ 实时更新：与GitHub自动同步
- 🤖 AI指导：加强工具说明和工作流程建议
MCP协议支持
- 工具：7个用于快速管理的专用工具
- 资源：13个以上用于浏览和发现的资源端点
- 鼓励：支持Handlebars的动态模板
📋 先决条件
安装前，请确保：
- 已安装Node.js 18+
- npm或yarn包管理器
- Git已安装并配置
- GitHub帐户（用于GitHub集成）
- GitHub个人访问令牌（用于私有仓库或避免速率限制）
🚀 安装
步骤1：克隆并安装
# Clone the repository
git clone https://github.com/jezweb/smart-prompts-mcp.git
cd smart-prompts-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Verify installation
./verify-install.sh步骤2：配置环境
创建一个 .env 项目根目录中的文件：
# Required: GitHub Configuration
GITHUB_OWNER=your-username # Your GitHub username or org
GITHUB_REPO=your-prompts-repo # Repository containing prompts
GITHUB_BRANCH=main # Branch to use (default: main)
GITHUB_PATH= # Subdirectory path (optional)
GITHUB_TOKEN=ghp_xxxxx # Personal access token (recommended)
# Optional: Cache Configuration
CACHE_TTL=300000 # Cache time-to-live in ms (default: 5 min)
CACHE_REFRESH_INTERVAL=60000 # Auto-refresh interval in ms (default: 1 min)
# Optional: Feature Flags
ENABLE_SEMANTIC_SEARCH=true # Advanced search features
ENABLE_PROMPT_COMPOSITION=true # Prompt combination features
ENABLE_USAGE_TRACKING=true # Track prompt usage步骤3:MCP客户端配置
适用于Claude Desktop（macOS）
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"smart-prompts": {
"command": "node",
"args": ["/absolute/path/to/smart-prompts-mcp/dist/index.js"],
"env": {
"GITHUB_OWNER": "your-username",
"GITHUB_REPO": "your-prompts-repo",
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}对于Roo Cline（VS代码）
添加到Roo-Cline MCP设置：
"smart-prompts": {
"command": "node",
"args": ["/absolute/path/to/smart-prompts-mcp/dist/index.js"],
"env": {
"GITHUB_OWNER": "your-username",
"GITHUB_REPO": "your-prompts-repo",
"GITHUB_TOKEN": "ghp_your_token_here"
}
}📁 快速组织最佳实践
推荐的文件夹结构
your-prompts-repo/
├── README.md # Repository overview
├── ai-prompts/ # AI and meta-prompts
│ ├── meta-prompt-builder.md
│ └── prompt-engineer.md
├── development/ # Development prompts
│ ├── backend/
│ │ ├── api-design.md
│ │ └── database-schema.md
│ ├── frontend/
│ │ ├── react-component.md
│ │ └── vue-composition.md
│ └── testing/
│ ├── unit-test-writer.md
│ └── e2e-test-suite.md
├── content-creation/ # Content prompts
│ ├── blog-post-writer.md
│ └── youtube-metadata.md
├── business/ # Business prompts
│ ├── proposal-generator.md
│ └── email-templates.md
└── INDEX.md # Optional: Category index命名约定
- 文件：使用烤肉串盒（例如。，
api-documentation-generator.md) - 提示名称：在正面使用snake_case（例如。，
api_documentation_generator) - 分类：使用带连字符的小写字母（例如。，
content-creation) - 保持名称的描述性 但简洁明了
📝 提示文件格式
---
name: api_documentation_generator
title: REST API Documentation Generator
description: Generate comprehensive API documentation with examples
category: documentation
tags: [api, rest, documentation, openapi, swagger]
difficulty: intermediate
author: jezweb
version: 1.0
arguments:
- name: api_spec
description: The API specification or endpoint details
required: true
- name: format
description: Output format (markdown, openapi, etc)
required: false
default: markdown
---
# API Documentation Generator
Generate comprehensive documentation for {{api_spec}} in {{format}} format.
Include:
- Endpoint descriptions
- Request/response examples
- Authentication details
- Error codes
- Rate limiting information🛠️ 可用工具
- 🔍
search_prompts-永远从这里开始！按关键字、类别或标签搜索 - 📋
list_prompt_categories-使用计数浏览可用类别 - 📖
get_prompt-检索特定提示（使用搜索中的确切名称） - ✨
create_github_prompt-在GitHub中创建新提示 - 🔗
compose_prompts-组合多个提示 - ❓
prompts_help-获取上下文帮助和指导 - ✅
check_github_status-验证GitHub连接
推荐工作流程
1. search_prompts → Find existing prompts
2. get_prompt → View full content
3. compose_prompts → Combine if needed
4. create_github_prompt → Only if nothing exists🔧 故障排除
常见问题
1.“GitHub访问失败”错误
# Check your token has repo scope
# Verify token in .env file
GITHUB_TOKEN=ghp_your_actual_token
# Test GitHub access
GITHUB_TOKEN=your_token node test-server.js2.“超出速率限制”错误
- 添加GitHub令牌以提高速率限制
- 缩短缓存刷新间隔
- 使用
CACHE_TTL缓存时间更长
3.“未找到提示”
- 检查存储库结构是否与预期格式匹配
- 如果使用子目录，请验证GITHUB_PATH
- 确保.md文件具有YAML frontmatter
4.MCP客户端未连接
- 在配置中使用绝对路径
- 检查Node.js是否在PATH中
- 验证所有环境变量
- 检查日志：
tail -f ~/.claude/logs/mcp.log
5.性能缓慢
- 增加
CACHE_TTL更新频率较低 - 减小存储库大小（存档旧提示）
- 使用类别限制搜索范围
📈 缩放注意事项
当前限制
- GitHub API速率限制
- 60个请求/小时（未经验证） - 5000个请求/小时（已验证） - 每个目录获取=1个请求
- 搜索限制
- GitHub中没有原生语义搜索 - 线性搜索所有文件 - 100多次提示会降低性能
扩展策略
50-200个提示
- ✅ 目前的实施效果良好
- 使用类别和标签进行组织
- 实现本地缓存
- 添加GitHub令牌以获得更高的速率限制
200-1000个提示
- 🔄 实现索引文件
# INDEX.md in repo root
prompts:
- name: api_generator
path: development/api-generator.md
category: development
tags: [api, codegen]- 📊 添加搜索索引
- 在构建时生成搜索索引 - 存储于 search-index.json - 通过GitHub操作更新
获得1000+提示
- 🗄️ 数据库层
- SQLite用于本地缓存 - 全文搜索功能 - 定期与GitHub同步
- 🔍 Elasticsearch/Algolia集成
- 适当的搜索基础设施 - 面搜索 - 相关性排名
未来扩展功能（路线图）
- 搜索索引生成
- GitHub构建索引的行动 - 下载单个索引文件 - 局部语义搜索
- 延迟加载
- 按需获取类别 - 渐进增强 - 大列表的虚拟滚动
- CDN支持
- 边缘缓存提示 - 减少对GitHub API的调用 - 更快的全球访问
🚀 未来MCP服务器构想
基于GitHub集成模式，以下是潜在的MCP服务器：
1. 代码段MCP服务器
在GitHub中存储和管理可重用代码片段
- 特定语言组织
- 语法突出显示
- 依赖管理
- 版本历史
2. 文档模板MCP
基于GitHub的文档模板库
- README生成器
- API文档模板
- 项目文件
- 由代码自动生成
3. AI人物MCP服务器
管理AI个性配置
- 专业知识定义
- 沟通方式
- 行为特征
- 团队共享
4. 项目脚手架MCP
完整的项目模板管理
- 技术栈
- 样板代码
- 最佳实践
- 配置预设
5. 学习资源MCP
精心策划的教育内容
- 教程与指南
- 代码示例
- 进度跟踪
- 基于技能的建议
6. 配置管理器MCP
版本控制的应用程序配置
- 环境管理
- 秘密处理
- 团队同步
- 回滚支持
7. 工作流自动化MCP
GitHub操作集成
- 工作流模板
- CI/CD管道
- 自动化脚本
- 跨仓库编排
8. 知识库MCP
团队知识管理
- 问答配对
- 故障排除指南
- 最佳实践
- 可搜索维基
🧪 测试
服务器包括全面的测试，以确保可靠性和性能。
测试套件功能
- 100%测试覆盖率 关键功能
- 性能基准 有详细的指标
- 视觉测试报告 带有交互式图表
- 自动化CI/CD 通过GitHub操作
运行测试
# Run full test suite
npm test
# Watch mode for development
npm run test:watch
# Generate coverage report
npm run test:coverage
# Run performance benchmark
npm run test:perf
# Verify installation
npm run test:verify测试报告
测试结果以多种格式自动生成：
- 对象符号：详细分析结果(
test-results/latest.json) - 降价：人类可读的报告(
test-results/latest.md) - 超文本标记语言：交互式视觉报告(
test-results/latest.html)
查看最新测试结果：
🧪 发展
# Development mode with hot reload
npm run dev
# Build for production
npm run build
# Start production server
npm start🤝 贡献
我们欢迎捐款！看 贡献.md 作为指导方针。
优先领域
- 搜索改进
- 实现模糊搜索 - 添加搜索结果排名 - 支持正则表达式模式
- 性能优化
- 实现连接池 - 添加请求批处理 - 优化缓存策略
- UI/可视化
- 用于浏览的Web界面 - 提示预览工具 - 使用分析仪表板
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
🙏 致谢
📞 支持
- 问题:
- 讨论:
- 例子: jezweb/提示
______________________________________________________________________
Made with ❤️ for the MCP community