使用说明

项目简介

Koding.js MCP服务器是一个基于Node.js开发的后端应用，它实现了Model Context Protocol (MCP) 协议，旨在为大型语言模型 (LLM) 客户端提供结构化的上下文信息和功能扩展。该服务器允许客户端通过标准化的JSON-RPC接口访问和操作资源、调用工具，从而增强LLM应用的能力。

主要功能点

• 资源管理 (Resources)：
  • 提供资源列表查询
  • 支持读取资源内容
  • 允许客户端订阅资源更新
  • 支持资源模板
  • 提供资源列表变更通知
• 工具执行 (Tools)：
  • 提供可用工具列表查询
  • 支持调用已注册的工具，并传递参数
  • 返回工具执行结果
  • 提供工具列表变更通知
• 协议支持：
  • 基于JSON-RPC 2.0协议通信
  • 支持Stdio传输协议
• 能力声明：
  • 服务器声明自身支持的工具和资源能力

安装步骤

1. 前提条件：确保已安装 Node.js (版本 14 或更高) 和 npm。
2. 安装依赖：在仓库根目录下，打开终端并执行以下命令安装项目依赖：

   npm install
   

服务器配置

MCP客户端需要配置以下信息以连接到 Koding.js MCP服务器。以下是一个典型的 JSON 配置示例，请根据实际情况进行调整。

{
  "serverName": "koding-mcp-server",
  "command": "node",
  "args": ["mcp.js"]
}

配置参数说明：

• 'serverName': MCP服务器的名称，客户端用于标识连接的服务器。（可自定义，例如：'koding-mcp'）
• 'command': 启动 MCP 服务器的命令。对于 Koding.js MCP服务器，使用 'node' 命令来执行 JavaScript 文件。
• 'args': 启动命令的参数。这里指定执行 'mcp.js' 文件，该文件是 Koding.js MCP 服务器的入口点。

基本使用方法

1. 启动服务器：安装依赖完成后，在仓库根目录下，执行以下命令启动 MCP 服务器：

   npm start
   

   服务器默认监听标准输入输出 (stdio) 进行通信。

2. 运行客户端示例 (可选)：仓库中包含一个简单的客户端示例，可以运行它来测试服务器的基本功能：

   npm run client
   

   该客户端会连接到 MCP 服务器，列出可用工具和资源，并演示基本操作。

注意：

• 服务器启动后，会通过标准输出 (stdout) 打印日志信息，方便调试和监控服务器运行状态。
• 客户端通过标准输入 (stdin) 发送 JSON-RPC 请求，服务器通过标准输出 (stdout) 返回 JSON-RPC 响应。