项目简介

Cozy API项目旨在帮助AI智能体与外部API或功能进行交互。其中的MCP服务组件实现了Model Context Protocol (MCP) 规范，作为一个独立的后端服务，通过标准化协议（如Stdio）与兼容的LLM客户端通信，提供工具调用等能力。

主要功能点

• 工具注册与调用: 允许开发者注册自定义功能（Tools），供AI智能体通过MCP协议调用。目前实现了一个简单的求和工具作为示例。
• 能力声明: 服务器启动时向客户端声明其支持的能力，如日志记录和工具调用。
• Stdio传输支持: 通过标准输入/输出来与LLM客户端进行通信。

安装步骤

1. 确保您的系统已安装以下依赖：

   • Rust
   • mise (用于管理项目环境和运行命令)

2. 克隆仓库到本地。

3. 使用mise安装项目依赖：

   mise install
   

4. 设置项目环境：

   mise setup
   

服务器配置 (供MCP客户端使用)

MCP客户端需要以下信息来连接到Cozy API MCP服务器：

{
  // 服务器的标识名称，可以是用户友好的字符串
  "name": "Cozy API MCP",

  // 启动MCP服务器进程的命令
  "command": "cozyapi",

  // 传递给命令的参数列表，用于指定启动MCP模式
  "args": ["mcp"],

  // 使用的传输协议，此服务器支持Stdio
  "transport": "stdio"
}

基本使用方法

1. 通过mise命令启动Cozy API的MCP服务器：

   mise run dev:mcp
   

   或者，在构建后直接运行：

   # 首先构建项目（假设您已完成安装步骤）
   # mise build
   # 然后运行MCP服务器（路径可能需要根据您的构建配置调整）
   # ./target/release/cozyapi mcp
   

2. 服务器将通过Stdio协议等待连接。
3. 兼容Model Context Protocol的LLM客户端可以使用上述“服务器配置”信息来启动并连接到此服务器。
4. 连接成功后，客户端将获取服务器的能力信息，并可以调用已注册的工具（如示例中的加法工具）。