使用说明

项目简介

Montano MCP 服务器是一个基于 TypeScript 开发的 MCP (Model Context Protocol) 服务器，旨在为 LLM (大型语言模型) 应用提供上下文信息和功能扩展。它允许开发者注册和管理工具，并通过 JSON-RPC 协议与 MCP 客户端（如 Cursor IDE）进行通信，实现 LLM 对外部功能的调用。

主要功能点

工具注册与执行: 允许开发者注册自定义工具，例如示例中的 'greet' 工具，LLM 客户端可以调用这些工具执行特定任务。
标准 MCP 协议支持: 遵循 Model Context Protocol 规范，确保与任何兼容 MCP 协议的客户端互操作。
多种传输协议支持: 支持 Stdio 和 SSE (Server-Sent Events) 两种传输协议，满足不同应用场景的需求。
开发和生产模式: 提供便捷的开发模式（'npm run dev'）和优化的生产模式（'npm run build && npm start'）。

安装步骤

克隆仓库: 打开终端，执行以下命令克隆仓库到本地：

git clone [email protected]/lucasmontano/mcp-montano-server.git
cd mcp-montano-server

安装依赖: 在项目根目录下，执行以下命令安装项目依赖：
```
npm install
```

服务器配置

要将 Montano MCP 服务器添加到 MCP 客户端（例如 Cursor IDE），您需要配置客户端以连接到此服务器。以下是 Cursor IDE 的 'settings.json' 示例配置，展示如何配置 'montano-mcp-server'：

{
  "mcpServers": {
    "montano-mcp-server": {
      "command": "node",
      "args": ["path/to/mcp-montano-server/build/index.js"]
    }
  }
}

配置参数说明:

'"montano-mcp-server"': 服务器名称，您可以自定义，用于在客户端中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 'node' 解释器来运行 JavaScript 代码。
'"args": ["path/to/mcp-montano-server/build/index.js"]': 传递给 'node' 命令的参数，指定服务器入口文件 'index.js' 的路径。 请将 'path/to/mcp-montano-server' 替换为您的 'mcp-montano-server' 仓库在您本地文件系统中的实际路径。 例如，如果您的仓库在用户目录下的 'Documents/mcp-montano-server' 文件夹中，则应将 'path/to/mcp-montano-server' 替换为 '/Users/your_username/Documents/mcp-montano-server' (macOS/Linux) 或 'C:\Users\your_username\Documents\mcp-montano-server' (Windows)。

基本使用方法

启动服务器:
- 开发模式: 在项目根目录下运行 'npm run dev'，服务器将以开发模式启动，并使用 Stdio 传输协议。
- 生产模式: 先运行 'npm run build' 构建项目，然后运行 'npm start'，服务器将以生产模式启动，默认使用 Stdio 传输协议。
您可以通过在启动命令后添加 'sse' 参数来指定使用 SSE 传输协议。例如，使用 SSE 协议启动开发模式：'npm run dev sse'，生产模式：'node build/index.js sse'。使用 SSE 协议时，服务器将在 'http://localhost:8765/sse' 提供服务。
配置 MCP 客户端: 根据您使用的 MCP 客户端（例如 Cursor IDE）的文档，配置 MCP 服务器连接。通常需要提供服务器名称、启动命令和参数。参考上述的 'settings.json' 配置示例。
在 MCP 客户端中使用工具: 一旦客户端成功连接到 Montano MCP 服务器，您就可以在客户端中调用服务器注册的工具。以 'greet' 工具为例，在支持工具调用的 MCP 客户端中，您可以使用类似 '@greet' 的语法并提供 'name' 参数来调用 'greet' 工具，服务器将返回问候语。

选择传输协议:

Stdio: 适用于客户端和服务器在同一机器上运行的情况，配置简单，无需额外网络端口。
SSE: 适用于客户端和服务器可能不在同一机器上，或者需要通过 HTTP 进行通信的场景。需要客户端支持 SSE 协议。

请注意: 首次使用前，请确保已安装 Node.js (v18 或更高版本) 和 npm。

关键词