JSON-RPC工具服务

一个遵循JSON-RPC 2.0规范的远程工具调用服务,支持通过HTTP POST请求调用预定义工具。

  • by evansliaudet
  • TypeScript
  • 云端部署
  • 更新于
在 GitHub 查看 evansliaudet/starterstory-mcp

使用说明

JSON-RPC工具服务

本文档提供了如何与JSON-RPC服务交互的说明,该服务允许您调用预定义的工具。

API端点

所有请求都应发送到以下URL:

https://starterstory-mcp.onrender.com/mcp

如何提出请求

要使用该服务,您需要发送一个HTTP POST 请求到API端点。请求必须遵循JSON-RPC 2.0规范。

标头

您的请求必须包含以下标头:

  • Content-Type: application/json:表示请求正文为JSON格式。
  • Accept: application/json, text/event-stream:指定您的客户端可以处理标准JSON响应或事件流。

请求体

你的身体 POST 请求应该是一个具有以下结构的JSON对象:

  • jsonrpc (字符串): 必修的。 必须是 "2.0".
  • id (数字|字符串): 必修的。 请求的唯一标识符。服务器将在其响应中使用此相同的ID。
  • method (字符串): 必修的。 要调用的方法。对于调用工具,这应该是 "tools/call".
  • params (对象): 必修的。 包含方法参数的对象。
    • name (string):要调用的工具的名称。
    • arguments (object):包含指定工具参数的对象。

示例请求

以下是一个如何调用的示例 search_transcripts 工具使用 curl此工具在一组成绩单中搜索给定的查询。

curl -X POST https://starterstory-mcp.onrender.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_transcripts",
    "arguments": { "query": "best marketing channel" }
  }
}'

可用工具

以下是已知工具及其论据的列表。

search_transcripts

根据查询搜索成绩单。

  • 参数:
    • query (string):要搜索的文本。