Soracom Knowledge MCP server
Commit 8. Okt. 2026Lass KI-Agenten in Soracom Service Guides, API-Referenzen, IoT-Recipes und CLI-Commands suchen, um Antworten auf Basis der offiziellen Dokumentation zu generieren.
Auch bekannt als soracom/mcp, knowledge
- Stars
- 4
- Tools
- 9
- Downloads, 30 Tage
- —
- Neueste Version
- 1.1.5
- Letzter Commit
- 8. Okt. 2026
- Lizenz
- MIT
Was ist Soracom Knowledge MCP?
Soracom Knowledge ist ein MCP server. Lass KI-Agenten in Soracom Service Guides, API-Referenzen, IoT-Recipes und CLI-Commands suchen, um Antworten auf Basis der offiziellen Dokumentation zu generieren. Er stellt 9 Tools bereit, etwa query, document_names, search_mode.
Zusammenfassung generiert aus dem README des Projekts
Über Soracom Knowledge MCP server
Dieser MCP server ermöglicht es Entwicklern, die IoT-Lösungen bauen, ihre KI-Agenten mit der offiziellen Soracom-Dokumentation zu verknüpfen. Durch die Verbindung zu diesem Remote Read-only-Endpoint via HTTP-Transport können Clients wie Claude Code oder OpenAI Codex auf Service Guides, API-Referenzen und IoT-Recipes zugreifen. Das verhindert, dass sich Agenten allein auf veraltete Trainingsdaten verlassen, indem es Echtzeit-Zugriff auf technische Spezifikationen bietet.
Der Server stellt drei spezifische Tools bereit: search_soracom_docs zum Finden von Service-Übersichten und Preisen, search_api_docs zum Nachschlagen von CLI-Commands, SAM-Berechtigungen und API-Endpoints sowie get_document, um den vollständigen Markdown-Inhalt einer bestimmten Seite abzurufen. Nutzer können zwischen Keyword-, semantischer oder Hybrid-Suche wählen, um ihre Ergebnisse zu verfeinern.
Da der Server semantische Suche nutzt, werden Anfragen mittels OpenAI Embeddings verarbeitet. Das Setup für Remote-Clients ist unkompliziert und erfordert lediglich den HTTPS-Endpoint. Er ist ausschließlich für das Lesen öffentlicher Informationen konzipiert und hat keine Möglichkeit, Ressourcen in einem Soracom-Konto oder Nutzerdaten zu verändern.
Was du damit machen kannst
- 1Offizielle API-Spezifikationen abrufenLass einen KI-Agenten die spezifische HTTP-Methode und den Pfad für einen Soracom Service-Endpoint finden.
- 2IoT-Implementierungsleitfäden konsultierenNutze einen KI-Agenten, um nach spezifischen IoT-Recipes zu suchen, die bei der Implementierung von Connectivity-Lösungen helfen.
- 3Vollständige Dokumentationsinhalte extrahierenWeise einen Agenten an, den kompletten Markdown-Text einer spezifischen Dokumentationsseite zu lesen, die während einer Suche gefunden wurde.
- 4Service-Preise und Abläufe prüfenNutze natürliche Sprache, um Informationen zu Soracom Service-Kosten oder Schritten in der User Console zu finden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Soracom Knowledge MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenSoracom Knowledge MCP in Claude Code installieren
$ claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/Soracom Knowledge MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Soracom Knowledge MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"knowledge": {
"type": "http",
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Soracom Knowledge MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"knowledge","type":"http","url":"https://knowledge-mcp.soracom.com/"}'Soracom Knowledge MCP in Codex installieren
$ codex mcp add knowledge --url https://knowledge-mcp.soracom.com/Soracom Knowledge MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.knowledge] url = "https://knowledge-mcp.soracom.com/"
Soracom Knowledge MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http knowledge https://knowledge-mcp.soracom.com/Soracom Knowledge MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/",
"type": "http"
}
}
}Soracom Knowledge MCP tools 9
Erkannt aus dem READMEquerydocument_namessearch_modelanguagemax_resultstagmethodpathurl
| query | — | |
| document_names | — | |
| search_mode | — | |
| language | — | |
| max_results | — | |
| tag | — | |
| method | — | |
| path | — | |
| url | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarsoracom/mcp is public and reachablegithub.com/soracom/mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-08github.com/soracom/mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 574 msBestanden
README
Auf GitHub ansehenSoracom 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 Fragen
Wie füge ich Soracom Knowledge MCP zu Claude Code hinzu?
Führe claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/ in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Soracom Knowledge MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Soracom Knowledge MCP?
Er stellt 9 Tools bereit, darunter query, document_names, search_mode, language, max_results.
Ändert dieser Server mein Soracom-Konto?
Nein, der Server ist ein Read-only-Endpoint, der Dokumentationen lediglich durchsucht und liest, ohne Ressourcen zu verändern.
Ist eine Authentifizierung erforderlich, um den Server zu nutzen?
Der Server erfordert keine Authentifizierung pro Nutzer, da er nur auf öffentliche Dokumentationen zugreift.
Welche Suchmodi sind verfügbar?
Du kannst Hybrid Search nutzen, die Keyword- und semantische Suche kombiniert, oder dich zwischen reiner Keyword-Suche oder rein semantischer Suche entscheiden.