Prem MCP 服务器

一个用于 Prem AI 的模型上下文协议 (MCP) 服务器实现，能够与 Claude 和其他 MCP 兼容的客户端无缝集成。此服务器通过 MCP 接口提供对 Prem AI 强大功能的访问。

功能

• 🤖 聊天补全: 与 Prem AI 的语言模型互动
• 📚 RAG 支持: 具有文档存储库集成的检索增强生成
• 📝 文档管理: 在存储库中上传和管理文档
• 🎭 模板系统: 使用预定义的提示模板来获得专门的输出
• ⚡ 流式响应: 实时流式传输模型输出
• 🛡️ 错误处理: 强大的错误处理和日志记录

前提条件

• Node.js (v16 或更高版本)
• 一个具有 API 密钥的 Prem AI 帐户
• 一个 Prem 项目 ID

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 prem-mcp-server：

npx -y @smithery/cli install @ucalyptus/prem-mcp-server --client claude

手动安装

# 使用 npm
npm install prem-mcp-server

# 使用 yarn
yarn add prem-mcp-server

# 使用 pnpm
pnpm add prem-mcp-server

配置

1. 环境变量

在您的项目根目录中创建一个 .env 文件：

PREM_API_KEY=your_api_key_here
PREM_PROJECT_ID=your_project_id_here

2. Cursor 配置

要将 Prem MCP 服务器与 Cursor 一起使用，请将以下内容添加到您的 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "PremAI": {
      "command": "node",
      "args": ["/path/to/your/prem-mcp/build/index.js", "--stdio"],
      "env": {
        "PREM_API_KEY": "your_api_key_here",
        "PREM_PROJECT_ID": "your_project_id_here"
      }
    }
  }
}

将 /path/to/your/prem-mcp 替换为您的项目目录的实际路径。

3. Claude Desktop 配置

对于 Claude Desktop 用户，请将以下内容添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "PremAI": {
      "command": "npx",
      "args": ["prem-mcp-server", "--stdio"],
      "env": {
        "PREM_API_KEY": "your_api_key_here",
        "PREM_PROJECT_ID": "your_project_id_here"
      }
    }
  }
}

用法

启动服务器

npx prem-mcp-server

示例提示

1. 基本聊天

让我们来聊聊人工智能。

2. 带有文档的 RAG

基于存储库 XYZ 中的文档，关于 [主题] 的关键点是什么？

3. 使用模板

使用模板 ABC 生成 [特定类型的内容]。

文档上传

该服务器支持将文档上传到 Prem AI 存储库以进行 RAG 操作。支持的格式：

• .txt
• .pdf
• .docx

API 参考

聊天补全参数

• query: 输入文本
• system_prompt: 自定义系统提示
• model: 模型标识符
• temperature: 响应随机性 (0-1)
• max_tokens: 最大响应长度
• repository_ids: RAG 的存储库 ID 数组
• similarity_threshold: 文档相似度阈值
• limit: 最大文档块数

模板参数

• template_id: 提示模板的 ID
• params: 模板特定的参数
• temperature: 响应随机性 (0-1)
• max_tokens: 最大响应长度

开发

# 克隆存储库
git clone https://github.com/yourusername/prem-mcp-server.git

# 安装依赖项
npm install

# 构建项目
npm run build

# 运行测试
npm test

故障排除

常见问题

1. 服务器未找到

   • 验证 claude_desktop_config.json 中的服务器路径
   • 检查服务器是否正在运行

2. API 密钥无效

   • 确保您的 Prem AI API 密钥有效
   • 检查 API 密钥是否具有所需的权限

3. 文档上传失败

   • 验证文件格式是否受支持
   • 检查文件权限
   • 确保存储库 ID 正确

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

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

致谢

• Prem AI 感谢他们强大的 AI 平台
• 模型上下文协议 感谢协议规范
• Anthropic 感谢 Claude 和 MCP 生态系统

支持

对于问题和功能请求，请使用 GitHub Issues 页面。