使用说明

项目简介

AgentRPC 是一个为 AI Agent 构建的通用 RPC (远程过程调用) 平台，旨在帮助开发者轻松地将各种功能和数据以标准化的方式提供给 AI 模型使用。它基于 Model Context Protocol (MCP) 构建，充当 MCP 服务器，使得 AI Agent 客户端能够通过 MCP 协议安全、便捷地访问和调用后端服务。AgentRPC 提供了多语言 SDK，支持在不同环境中部署和注册工具，极大地扩展了 AI Agent 的能力边界。

主要功能点

多语言支持: 提供 TypeScript, Go, Python SDK，方便使用不同语言开发工具和服务。
私有网络支持: 无需开放端口即可在私有 VPC 中注册和使用工具，保障安全性。
长时运行函数: 支持超过 HTTP 超时限制的长时间运行的函数调用。
全面的可观测性: 提供追踪、指标和事件，方便监控和问题排查。
自动故障转移: 智能健康跟踪和自动故障转移重试机制，提高系统稳定性。
兼容 MCP 和 OpenAI SDK: 开箱即用，支持 MCP 协议和 OpenAI SDK 兼容的 Agent。

安装步骤

获取 API 密钥: 访问 https://app.agentrpc.com 注册并获取您的 API 密钥 (AGENTRPC_API_SECRET)。

安装 Node.js SDK: 在您的项目中使用 npm, yarn 或 pnpm 安装 AgentRPC Node.js SDK。

npm install agentrpc

或

yarn add agentrpc

或

pnpm add agentrpc

服务器配置 (MCP 客户端)

要将 AgentRPC MCP 服务器配置到 MCP 客户端（例如 Claude Desktop 或 Cursor），您需要提供服务器的启动命令和必要的参数。以下是 JSON 格式的配置信息，请根据您的实际情况进行配置，并将 '<YOUR_API_SECRET>' 替换为您在 https://app.agentrpc.com 获取的 API 密钥。

{
  "mcpServers": {
    "agentrpc": { // 服务器名称，可以自定义
      "command": "npx", // 启动命令，这里使用 npx 执行 agentrpc 包
      "args": [
        "-y", // 自动确认执行 npx 命令
        "agentrpc", // 执行 agentrpc 包
        "mcp" // 启动 MCP 服务器的子命令
      ],
      "env": {
        "AGENTRPC_API_SECRET": "<YOUR_API_SECRET>" // 环境变量，用于传递 API 密钥
      }
    }
  }
}

基本使用方法

安装 SDK: 按照安装步骤安装 AgentRPC Node.js SDK。
注册工具: 使用 SDK 注册您希望 AI Agent 调用的函数或工具。您可以参考 'sdk-node/examples/register.ts' 示例代码，定义工具的名称、描述、参数 schema 和处理函数 handler。
启动 MCP 服务器: 在您的终端中，使用命令 'ANGENTRPC_API_SECRET=<YOUR_API_SECRET> npx agentrpc mcp' 启动 AgentRPC MCP 服务器。请确保将 '<YOUR_API_SECRET>' 替换为您的实际 API 密钥。
配置 MCP 客户端: 将上面提供的服务器配置 JSON 添加到您的 MCP 客户端配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json' 或 Cursor 的 '~/.cursor/mcp.json'）。
AI Agent 调用工具: 配置完成后，您的 AI Agent 即可通过 MCP 协议连接到 AgentRPC MCP 服务器，并发现和调用您注册的工具。

AgentRPC

使用说明

服务器信息