Soracom Knowledge MCPサーバー
コミット 2026年10月8日AIエージェントがSoracomのサービスガイド、APIリファレンス、IoTレシピ、CLIコマンドを検索し、公式ドキュメントに基づいた回答を生成できるようにします。
別名 soracom/mcp, knowledge
- スター
- 4
- ツール
- 9
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.1.5
- 最終コミット
- 2026年10月8日
- ライセンス
- MIT
Soracom Knowledge MCPとは
Soracom KnowledgeはMCPサーバーです。 AIエージェントがSoracomのサービスガイド、APIリファレンス、IoTレシピ、CLIコマンドを検索し、公式ドキュメントに基づいた回答を生成できるようにします。. 9個のツールを提供しており、query, document_names, search_modeなどがあります。
プロジェクトのREADMEから生成された概要
Soracom Knowledge MCP server について
このMCP serverは、IoTソリューションを構築する開発者が、AIエージェントにSoracomの公式ドキュメントに基づいた回答を行わせることを可能にします。HTTPトランスポートを介してこのリモート読み取り専用エンドポイントに接続することで、Claude CodeやOpenAI Codexなどのクライアントが、サービスガイド、APIリファレンス、IoTレシピにアクセスできます。これにより、技術仕様へのリアルタイムなアクセスが可能になり、エージェントが古い学習データのみに依存することを防ぎます。
サーバーは3つの特定のツールを提供します。サービス概要や料金を見つけるためのsearch_soracom_docs、CLIコマンド、SAM権限、APIエンドポイントを調べるためのsearch_api_docs、そして特定のページのMarkdownコンテンツ全体を取得するためのget_documentです。ユーザーは検索結果を絞り込むために、キーワード、セマンティック、またはハイブリッド検索モードを選択できます。
サーバーはセマンティック検索を使用するため、クエリはOpenAI embeddingsを使用して処理されます。リモートクライアントの設定は、HTTPSエンドポイントを指定するだけで完了するため非常に簡単です。本サーバーは公開情報の読み取り専用として設計されており、Soracomアカウントのリソースやユーザーデータを変更する機能は持っていません。
できること
- 1公式API仕様の取得Soracomサービスエンドポイントの具体的なHTTPメソッドやパスをAIエージェントに探させます。
- 2IoT実装ガイドの参照接続ソリューションの実装を支援するために、特定のIoTレシピをAIエージェントに検索させます。
- 3ドキュメント全文の抽出検索で見つかった特定のドキュメントページのMarkdownテキスト全体を読み取るようエージェントに指示します。
- 4サービス料金と手順の確認自然言語を使用して、Soracomのサービスコストやユーザーコンソールの操作手順に関する情報を検索します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Soracom Knowledge MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにSoracom Knowledge MCPをインストール
$ claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/CursorにSoracom Knowledge MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/"
}
}
}VS CodeにSoracom Knowledge MCPをインストール
.vscode/mcp.json
{
"servers": {
"knowledge": {
"type": "http",
"url": "https://knowledge-mcp.soracom.com/"
}
}
}VS Code CLIにSoracom Knowledge MCPをインストール
$ code --add-mcp '{"name":"knowledge","type":"http","url":"https://knowledge-mcp.soracom.com/"}'CodexにSoracom Knowledge MCPをインストール
$ codex mcp add knowledge --url https://knowledge-mcp.soracom.com/Codex config.tomlにSoracom Knowledge MCPをインストール
~/.codex/config.toml
[mcp_servers.knowledge] url = "https://knowledge-mcp.soracom.com/"
Gemini CLIにSoracom Knowledge MCPをインストール
$ gemini mcp add -s user --transport http knowledge https://knowledge-mcp.soracom.com/Gemini settings.jsonにSoracom Knowledge MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/",
"type": "http"
}
}
}Soracom Knowledge MCPツール 9
READMEから検出querydocument_namessearch_modelanguagemax_resultstagmethodpathurl
| query | — | |
| document_names | — | |
| search_mode | — | |
| language | — | |
| max_results | — | |
| tag | — | |
| method | — | |
| path | — | |
| url | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能soracom/mcp is public and reachablegithub.com/soracom/mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-08github.com/soracom/mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない9 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 574 ms合格
README
GitHubで見る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.
| Parameter | Description |
|---|---|
query |
A natural-language search query (required). |
document_names |
Restricts 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_mode |
hybrid (default; combines keyword and semantic search), keyword (keyword search only), or semantic (semantic similarity only). |
language |
English or Japanese. Auto-detected from the query when omitted. |
max_results |
Number of results to return. Default 16, maximum 32. |
search_api_docs
Searches Soracom API references, CLI commands, and SAM permissions.
| Parameter | Description |
|---|---|
query |
A natural-language question or an API endpoint name. Optional when at least one of tag, method, or path is supplied. |
tag |
Restricts results to a service tag (e.g., Sim, Subscriber, Flux). Case-insensitive exact match. |
method |
Restricts results to an HTTP method (e.g., GET, POST). Case-insensitive exact match. |
path |
Restricts results to an API path fragment (e.g., /sims). Case-insensitive substring match. |
search_mode |
hybrid (default; combines keyword and semantic search), keyword (keyword search only), or semantic (semantic similarity only). |
language |
English or Japanese. Auto-detected from query when query is provided. If you omit query, specify language explicitly. |
max_results |
Number 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.
| Parameter | Description |
|---|---|
url |
The 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:
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
hybridorsemanticsearch 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:
claude mcp add --transport http soracom-knowledge https://knowledge-mcp.soracom.com
Verify that the server is connected:
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:
codex mcp add soracom-knowledge --url https://knowledge-mcp.soracom.com
List configured servers to confirm:
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.
Soracom Knowledge MCPのよくある質問
Soracom Knowledge MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/を実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Soracom Knowledge MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Soracom Knowledge MCPが提供するツールは
9個のツールを提供しており、query, document_names, search_mode, language, max_resultsなどがあります。
このサーバーはSoracomアカウントの設定を変更しますか?
いいえ、このサーバーは読み取り専用のエンドポイントであり、リソースを変更することなくドキュメントの検索と読み取りのみを行います。
サーバーの使用に認証は必要ですか?
公開ドキュメントにのみアクセスするため、ユーザーごとの認証は必要ありません。
どのような検索モードが利用できますか?
キーワード検索とセマンティック検索を組み合わせたハイブリッド検索のほか、キーワードのみ、またはセマンティックのみのモードを選択できます。