使用说明

项目简介

Cali 是一个旨在帮助开发者更高效地构建 React Native 应用的 AI 智能体。'cali-mcp-server' 是 Cali 项目的 MCP (Model Context Protocol) 服务器端实现，它将 React Native 开发相关的各种工具封装并通过 MCP 协议提供给支持 MCP 协议的 LLM 客户端（如 Claude、Zed 等），使得 LLM 能够理解和执行 React Native 开发任务。

主要功能点

工具化 React Native CLI: 将 React Native 命令行工具的功能，例如应用构建、设备管理、依赖管理、库搜索等，转化为可被 LLM 调用的工具。
MCP 协议支持: 遵循 Model Context Protocol 标准，通过 JSON-RPC 协议与 LLM 客户端通信，提供标准化的上下文服务。
React Native 应用开发辅助: 允许 LLM 客户端通过调用服务器提供的工具，自动化执行 React Native 应用的构建、运行、调试以及库管理等任务。
Stdio 传输协议: 使用 Stdio 作为默认的传输协议，方便集成和部署。

安装步骤

克隆仓库

git clone https://github.com/callstackincubator/cali
cd cali

安装依赖 根据你使用的包管理器选择以下命令之一：

npm install

或者

yarn install

或者

pnpm install

构建 MCP 服务器 使用以下命令构建 'cali-mcp-server' 包：

npm run build -w packages/mcp-server

或者

yarn build -w packages/mcp-server

或者

pnpm build -w packages/mcp-server

构建成功后，'packages/mcp-server/dist' 目录下将生成服务器代码。

服务器配置

MCP 客户端需要配置连接到 'cali-mcp-server' 的信息。以下是一个典型的 JSON 格式配置示例，你需要将其配置到你的 MCP 客户端中。

{
  "serverName": "cali-mcp-server",  // 服务器名称，用于在客户端中标识
  "command": "node",                 // 启动服务器的命令，这里使用 Node.js 运行
  "args": ["packages/mcp-server/dist/index.esm.js"] // 启动命令的参数，指向构建后的服务器入口文件
}

配置说明:

'serverName': 服务器的名称，可以自定义，用于在 MCP 客户端中识别和管理不同的 MCP 服务器连接。
'command': 启动 MCP 服务器进程的命令。由于 'cali-mcp-server' 是一个 Node.js 应用，这里使用 'node' 命令来运行 JavaScript 文件。
'args': 传递给 'command' 的参数，用于指定服务器的入口文件路径。'packages/mcp-server/dist/index.esm.js' 是构建后 MCP 服务器的入口文件，确保路径正确。

基本使用方法

启动 MCP 服务器: 在你的终端中，使用配置中 'command' 和 'args' 指定的命令来启动 'cali-mcp-server'。例如，在 'cali' 仓库根目录下执行：
```
node packages/mcp-server/dist/index.esm.js
```
服务器启动后，将通过 Stdio 等待 MCP 客户端的连接和请求。
配置和连接 MCP 客户端: 在你的 MCP 客户端（如 Claude、Zed 等）中，根据客户端的指引，配置上述提供的服务器连接信息。客户端配置成功后，应能自动连接到 'cali-mcp-server'。
使用 LLM 客户端进行 React Native 开发: 通过 LLM 客户端，你可以使用自然语言指示 AI 智能体执行各种 React Native 开发任务。客户端会将你的指令转换为 MCP 请求发送到 'cali-mcp-server'，服务器会调用相应的 React Native 工具来完成任务，并将结果返回给客户端。

例如，你可以指示 LLM 客户端 “Build my app for iOS” 或 “Install react-navigation library”。客户端会将这些指令转化为工具调用请求，通过 'cali-mcp-server' 执行，从而实现 AI 辅助的 React Native 应用开发。

关键词