跳过主要内容
广告OpenFree logo推广你的产品触达更多潜在用户,助力产品增长与收益提升。投放广告

OpenFree MCP 使用指南

通过模型上下文协议(MCP),你可以在 AI 助手中搜索 OpenFree 收录的免费和开源 AI 工具。

服务地址
https://openfree.tools/mcp
传输方式
Streamable HTTP
身份验证
无需账号或 API Key

连接客户端

Claude Code

claude mcp add --transport http openfree https://openfree.tools/mcp

Codex

codex mcp add openfree --url https://openfree.tools/mcp

其他 MCP 客户端

添加名为 openfree 的远程服务,选择 Streamable HTTP,粘贴上方的服务地址。如果客户端支持用 mcpServers JSON 配置 HTTP 服务,可以使用下面的配置。

{
  "mcpServers": {
    "openfree": {
      "type": "http",
      "url": "https://openfree.tools/mcp"
    }
  }
}

试一次搜索

连接后,在客户端中打开一个新对话,试试这条指令。

用 OpenFree 搜索 Ollama,返回 3 条中文结果,附上 GitHub 仓库和 OpenFree 页面链接。

可用工具

4 个工具均可只读访问已发布的目录数据。将 locale 设为 zh 可获取中文结果,默认值 en 返回英文。

search_tools
用关键词(q)搜索。可按分类或标签的 slug 筛选,也可用 page 和 limit 分页,默认每页 10 条,最多 25 条。
get_tool
用完整的 slug 查询已发布的工具详情,例如 ollama。
list_categories
列出包含已发布工具的分类,返回分类 slug 和工具数量。
list_tags
列出已发布工具中使用最多的 50 个标签,返回标签 slug 和工具数量。

直接通过 HTTP 调用

通过 POST 发送 JSON-RPC 请求,将 Content-Type 设为 application/json,Accept 设为 application/json, text/event-stream。先发送 initialize,再发送 notifications/initialized。可用 tools/list 查看工具参数。后续请求(包括下方的 tools/call)需带上协商后的 MCP-Protocol-Version,无需会话 ID。

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_tools",
    "arguments": {
      "q": "Ollama",
      "locale": "zh",
      "limit": 3
    }
  }
}

工具返回的 JSON 文本位于 result.content[0].text。直接在浏览器中打开服务地址会发送 GET 请求并返回 405,这是正常的。