Prospect Research MCP Server
使用说明
项目简介
Prospect Research MCP Server 是一个实现了 Model Context Protocol (MCP) 协议的服务器端程序。它旨在为大型语言模型 (LLM) 应用提供上下文信息和功能支持。该服务器托管了 Prompt 模板和 Tool 工具,允许 LLM 客户端通过标准化的 MCP 协议与之交互,实现 Prompt 的渲染和 Tool 的调用。
主要功能点
- Prompt 模板管理: 内置 'simple-assist', 'research', 'review-code' 等 Prompt 模板,支持根据客户端请求渲染不同的 Prompt,定制 LLM 的行为模式。
- Tool 工具注册与执行: 集成了 'calculate-bmi', 'fetch-weather', 'search-information' 等 Tool 工具(示例实现),允许 LLM 客户端调用外部功能,扩展 LLM 的能力边界。
- 基于 MCP 协议: 遵循 MCP 协议规范,使用 JSON-RPC over Stdio 进行通信,易于与任何兼容 MCP 协议的 LLM 客户端集成。
- 简单易用: 代码结构清晰,配置简单,易于上手和二次开发,适合快速构建和测试 MCP 应用。
安装步骤
- 安装 Node.js 和 npm: 确保你的开发环境中已安装 Node.js 和 npm (Node 包管理器)。
- 克隆仓库: 将 GitHub 仓库 'https://github.com/jzhang17/prospect-research-mcp' 克隆到本地。
- 安装依赖: 在仓库根目录下,打开终端并执行以下命令安装项目依赖:
npm install
服务器配置
MCP 客户端需要配置以下 JSON 格式的信息以连接到 Prospect Research MCP Server:
{ "serverName": "prospect-research-server", "command": "npm", "args": ["run", "dev"] }
配置参数说明:
- 'serverName': 服务器名称,此处为 "prospect-research-server",与服务器代码中定义的一致。
- 'command': 启动服务器的命令,这里使用 'npm' 命令。
- 'args': 启动命令的参数,'["run", "dev"]' 表示执行 'npm run dev' 命令,该命令在 'package.json' 中定义,用于启动开发模式的服务器。
注意: 请确保你的 MCP 客户端能够执行 'npm' 命令,并且在执行命令时,工作目录位于 Prospect Research MCP Server 仓库的根目录下,以便 'npm run dev' 命令能够正确启动服务器。
基本使用方法
-
启动 MCP 服务器: 按照上述服务器配置,在 MCP 客户端中启动 Prospect Research MCP Server。服务器成功启动后,会在控制台输出 'MCP Server started with stdio transport'。
-
客户端请求交互: 使用 MCP 客户端,可以向 Prospect Research MCP Server 发送符合 MCP 协议的请求,例如:
- 获取 Prompt 列表: 客户端可以请求服务器获取所有可用的 Prompt 模板列表。
- 渲染 Prompt: 客户端可以指定 Prompt 名称和输入参数,请求服务器渲染并返回 Prompt 消息。
- 调用 Tool: 客户端可以指定 Tool 名称和输入参数,请求服务器执行 Tool 工具并返回结果。
具体的请求格式和交互方式请参考 Model Context Protocol (MCP) 协议文档和 MCP 客户端的文档。
示例:使用 'simple-assist' Prompt
客户端可以发送请求,指定使用 'simple-assist' Prompt,并提供 'query' 参数,例如:'{ "promptName": "simple-assist", "input": { "query": "今天天气如何?" } }'。服务器会根据 'simple-assist' Prompt 模板,生成包含用户query的 Prompt 消息,并返回给客户端,客户端再将 Prompt 消息发送给 LLM 进行后续处理。
示例:调用 'calculate-bmi' Tool
客户端可以发送请求,指定调用 'calculate-bmi' Tool,并提供 'weightKg' 和 'heightM' 参数,例如:'{ "toolName": "calculate-bmi", "input": { "weightKg": 70, "heightM": 1.75 } }'。服务器会执行 'calculate-bmi' Tool,计算 BMI 值,并将结果以 MCP 格式返回给客户端。