Vibe PRRM MCP

@wsvc/prrm-mcp

一个独立的MCP（模型上下文协议）服务器，代理对PRRM（投资组合研究和风险管理）REST API的工具调用。它不需要数据库连接，也不需要PRRM代码库依赖关系——只需要两个环境变量和一个正在运行的PRRM服务器。

建筑

+--------------+    stdio     +------------------+    HTTPS    +--------------+
|  Claude Code | ------------ |  prrm-mcp-client | ---------- |  PRRM VPS    |
|  / OpenClaw  |              |  (this package)  |            |  /api/v1/*   |
+--------------+              +------------------+            +--------------+

MCP服务器通过stdio与AI代理通信，并通过HTTP（S）将每个工具调用转发到PRRM REST API。所有响应都从标准中展开 { data: ... } 信封，并作为JSON文本内容返回。

快速开始

选项A：从npm安装（如果已发布）

# Run directly with npx (no install required)
PRRM_BASE_URL=https://prrm.example.com PRRM_API_TOKEN=your-token npx @wsvc/prrm-mcp

# Or install globally
npm install -g @wsvc/prrm-mcp
PRRM_BASE_URL=https://prrm.example.com PRRM_API_TOKEN=your-token prrm-mcp

选项B：从GitHub安装

如果包没有发布到npm，你可以直接从GitHub仓库安装：

# Install globally from GitHub (uses the packages/mcp-client directory)
npm install -g github:wsvc/Vibe-PRRM-MCP

# Or add to a project
npm install github:wsvc/Vibe-PRRM-MCP

您还可以在本地克隆和构建：

git clone https://github.com/wsvc/Vibe-PRRM-MCP.git
cd Vibe-PRRM-MCP/packages/mcp-client
npm install
npm run build
npm link   # makes 'prrm-mcp' available globally on your machine

# Then run it anywhere
PRRM_BASE_URL=https://prrm.example.com PRRM_API_TOKEN=your-token prrm-mcp

使用Claude代码进行配置

将以下内容添加到您的 claude_desktop_config.json 或 .claude.json.

从npm安装时：

{
  "mcpServers": {
    "prrm": {
      "command": "npx",
      "args": ["@wsvc/prrm-mcp"],
      "env": {
        "PRRM_BASE_URL": "https://prrm.example.com",
        "PRRM_API_TOKEN": "your-agent-token"
      }
    }
  }
}

从本地克隆安装时（调整克隆位置的路径）：

{
  "mcpServers": {
    "prrm": {
      "command": "node",
      "args": ["C:/path/to/Vibe-PRRM-MCP/packages/mcp-client/dist/index.js"],
      "env": {
        "PRRM_BASE_URL": "https://prrm.example.com",
        "PRRM_API_TOKEN": "your-agent-token"
      }
    }
  }
}

使用OpenClaw进行配置

将以下内容添加到您的 openclaw.json:

{
  "mcpServers": {
    "prrm": {
      "command": "npx",
      "args": ["@wsvc/prrm-mcp"],
      "env": {
        "PRRM_BASE_URL": "https://prrm.example.com",
        "PRRM_API_TOKEN": "${DOLLAR_BILL_PRRM_TOKEN}"
      }
    }
  }
}

环境变量

工具目录

该服务器在12个模块中公开了136个工具。每个工具都将1:1（对于合并的列表/获取工具为1:多）映射到PRRM REST API端点。

战略（3个工具）

仪器（8个工具）

评论（2个工具）

筛选与宇宙（32个工具）

研究（4种工具）

估值（15种工具）

投资委员会（16种工具）

投资组合（30种工具）

性能（8个工具）

风险（13种工具）

通知（4个工具）

平台（1个工具）

MCP资源

服务器公开一个MCP资源：

错误处理

服务器从不从工具处理程序抛出异常。HTTP错误被转换为文本内容，以便代理可以读取错误并做出适当的反应。

发展

先决条件

• Node.js 18+（使用内置 fetch)
• 正在运行的PRRM服务器实例

项目结构

packages/mcp-client/
  package.json
  tsconfig.json
  src/
    index.ts              # Entry point, MCP server setup, guide resource
    api-client.ts         # HTTP client wrapper (fetch + auth + error handling)
    tools/
      strategy.ts         # 3 tools
      instruments.ts      # 8 tools
      comments.ts         # 2 tools
      screening.ts        # 32 tools
      research.ts         # 4 tools
      valuation.ts        # 15 tools
      ic.ts               # 16 tools
      portfolio.ts        # 30 tools
      performance.ts      # 8 tools
      risk.ts             # 13 tools
      notifications.ts    # 4 tools
      platform.ts         # 1 tool

构建

cd packages/mcp-client
npm install
npm run build          # Compiles TypeScript to dist/

以开发模式运行

cd packages/mcp-client
PRRM_BASE_URL=http://localhost:3000 PRRM_API_TOKEN=test npm run dev

这使用 tsx 无需构建步骤即可动态执行TypeScript。

运行构建版本

cd packages/mcp-client
PRRM_BASE_URL=http://localhost:3000 PRRM_API_TOKEN=test npm start

出版

cd packages/mcp-client
npm run build
npm publish --access public

该包发布为 @wsvc/prrm-mcp 并且可以与一起运行 npx @wsvc/prrm-mcp 或全球安装。

许可证

有关许可证信息，请参阅存储库根目录。