Soracom Knowledge

com.soracom由 soracom.com 发布官方发布者v1.1.5更新于 Oct 24, 2026

Search SORACOM documentation: service guides, FAQ, API references, IoT recipes, etc.

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

一个托管的只读 MCP 端点，让助手搜索 SORACOM 文档与 API 参考，并获取完整页面内容。

可以做什么
搜索 SORACOM 服务指南、用户控制台操作说明、定价、更新日志和 IoT 案例，支持英文或日文，可选关键词、语义或混合模式并按站点过滤。搜索 API 参考、CLI 命令和 SAM 权限，可按服务标签、HTTP 方法或路径片段缩小范围。获取搜索结果中页面或 API schema 链接的完整 Markdown 内容。
适用场景
当助手需要回答关于 SORACOM 服务、用户控制台、定价、IoT 案例、SORACOM API 端点、soracom-cli 命令或 SAM 权限的问题，并希望答案基于官方文档而非仅凭训练数据时适用。
运行要求
需要一个支持 Streamable HTTP 的远程 MCP 客户端，并指向 SORACOM 的公开端点。无需账号、API 密钥或请求头。需要能访问该端点的网络。
安装前请注意
没有按用户区分的身份验证：每次查询都会发送到该端点，在混合或语义模式下还会发送给 OpenAI 生成向量，因此不要在查询中包含机密信息、账号标识、凭据或个人数据。服务为只读，不会修改 SORACOM 资源。结果可能与查询关联较弱，索引更新滞后于文档变更；重要信息请对照原始页面核实。免费、尽力而为、无 SLA，请求过多可能被限流。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Soracom Knowledge，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.soracom%2Fknowledge/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "soracom-knowledge": {
      "type": "http",
      "url": "https://knowledge-mcp.soracom.com/"
    }
  }
}

README

Soracom Knowledge MCP Server

The Soracom Knowledge MCP Server is an MCP (Model Context Protocol) server that lets AI agents search Soracom documentation and Soracom API references directly from your development environment. When connected to an MCP client such as Claude Code, OpenAI Codex, or Claude Desktop, the agent can look up service guides, Soracom User Console procedures, pricing, IoT recipes, Soracom API references, CLI commands, and SAM permissions on demand, and ground its answers in the official documentation instead of relying only on its training data.

The server is hosted by Soracom as a shared, read-only endpoint. It does not modify any of your Soracom resources—the agent only searches and reads documentation.

Available Tools

The server exposes three read-only tools to the connected agent. None of them modify your account or its resources.

The server's default hybrid search mode combines keyword search with semantic search (using OpenAI embeddings) and merges the results using Reciprocal Rank Fusion (RRF).

search_soracom_docs

Searches Soracom service guides, Soracom User Console procedures, service overviews and pricing, and IoT recipes.

ParameterDescription
queryA natural-language search query (required).
document_namesRestricts the search to specific sites (e.g., ["docs.soracom.io", "users.soracom.io"]). The available sites are listed in the tool schema. Omit it to search all sources.
search_modehybrid (default; combines keyword and semantic search), keyword (keyword search only), or semantic (semantic similarity only).
languageEnglish or Japanese. Auto-detected from the query when omitted.
max_resultsNumber of results to return. Default 16, maximum 32.

search_api_docs

Searches Soracom API references, CLI commands, and SAM permissions.

ParameterDescription
queryA natural-language question or an API endpoint name. Optional when at least one of tag, method, or path is supplied.
tagRestricts results to a service tag (e.g., Sim, Subscriber, Flux). Case-insensitive exact match.
methodRestricts results to an HTTP method (e.g., GET, POST). Case-insensitive exact match.
pathRestricts results to an API path fragment (e.g., /sims). Case-insensitive substring match.
search_modehybrid (default; combines keyword and semantic search), keyword (keyword search only), or semantic (semantic similarity only).
languageEnglish or Japanese. Auto-detected from query when query is provided. If you omit query, specify language explicitly.
max_resultsNumber of results to return. Default 16, maximum 32.

get_document

Fetches the full Markdown of a page returned by search_soracom_docs or search_api_docs.

ParameterDescription
urlThe URL of the page to fetch (required). Pass the url value from a search result verbatim. A search result may return a URL that is not directly viewable in a browser (such as a fragment of a split API reference), but this tool can still fetch its content.

Connecting the Server

The server is reachable at a stable public HTTPS endpoint and uses the MCP Streamable HTTP transport:

text
https://knowledge-mcp.soracom.com

[!WARNING] The server has no per-user authentication. It only searches and returns public Soracom documentation, but any query you enter is sent to the endpoint. With the hybrid or semantic search mode, your query is also sent to OpenAI to generate embeddings. Do not include confidential information, account identifiers, credentials, or personal data in your queries.

For Soracom's terms and privacy practices, see the Terms and Conditions and Privacy Policy. Soracom does not record or retain the content of your queries in its server logs. Soracom also does not share OpenAI API inputs or outputs with OpenAI for model improvement, evaluation, fine-tuning, or training. For details, see OpenAI's Business data privacy, security, and compliance.

Use of this server is subject to our Site Policy (available in Japanese), which includes disclaimers, copyright terms, and provides that use is governed by the laws of Japan, with the Tokyo District Court as the exclusive court of first instance. The Japanese text prevails.

Claude Code

Claude Code supports remote HTTP MCP servers natively. Add the server with the claude mcp add command:

bash
claude mcp add --transport http soracom-knowledge https://knowledge-mcp.soracom.com

Verify that the server is connected:

bash
claude mcp list

The soracom-knowledge server and its three tools are now available in your Claude Code sessions. To remove it later, run claude mcp remove soracom-knowledge.

OpenAI Codex

The Codex CLI supports remote MCP servers over HTTP. Add the server with:

bash
codex mcp add soracom-knowledge --url https://knowledge-mcp.soracom.com

List configured servers to confirm:

bash
codex mcp list

Notes and Limitations

  • This server is provided free of charge on a best-effort basis and without an SLA. Its specifications may change without notice as the service is improved.
  • Access may be temporarily restricted if an excessive number of requests are detected.
  • A result set may include pages that are only loosely related to your query. The agent is expected to filter these; treat individual hits as candidates rather than authoritative matches.
  • The information returned by this server is provided "AS-IS", and answers generated by an AI agent are not guaranteed to be accurate. Verify important details against the linked source pages.
  • The search index is updated periodically, so it may take some time for changes to the public documentation to be reflected in search results.

This page mirrors the official documentation: English | Japanese. Registry: com.soracom/knowledge on the Official MCP Registry.

来源：servers/knowledge/README.md，提交 081b555

工具

3

get_document

Get Full SORACOM Documentation Page

Fetch full markdown for a SORACOM documentation page. Also resolves API schema links. Exact URLs are attempted first.

输入参数url必填

search_api_docs

Search SORACOM API Documentation

Search SORACOM API documentation, CLI references, and SAM permissions. Use for exact API endpoints, soracom-cli commands, or SAM permission strings. Use search_soracom_docs for service guides, console how-tos, pricing, or IoT recipes. Use get_document on `#/schema/<Name>` links in results to read full API schema fields.

输入参数tagpathquerymethodlanguagemax_resultssearch_mode

search_soracom_docs

Search SORACOM Documentation

Search SORACOM service documentation, guides, and console how-to articles (user site, service overviews and pricing, IoT recipes). Covers SORACOM services, subscription plans, User Console operations, changelogs, blogs, devices, IoT Store, partners, contract terms, and use cases. Use search_api_docs for API references, CLI commands, or SAM permissions.

输入参数query必填marketlanguagemax_resultssearch_modedocument_names

版本历史

2
  1. v1.1.5最新Oct 8, 2026
  2. v1.1.4Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分