Serveur MCP Soracom Knowledge
Commit 8 oct. 2026Permettez à vos agents IA de rechercher dans les guides de service, les références API, les recettes IoT et les commandes CLI de Soracom pour ancrer leurs réponses dans la documentation officielle.
Aussi connu sous soracom/mcp, knowledge
- Étoiles
- 4
- Outils
- 9
- Téléchargements, 30 jours
- —
- Dernière version
- 1.1.5
- Dernier commit
- 8 oct. 2026
- Licence
- MIT
Qu'est-ce que Soracom Knowledge MCP ?
Permettez à vos agents IA de rechercher dans les guides de service, les références API, les recettes IoT et les commandes CLI de Soracom pour ancrer leurs réponses dans la documentation officielle. Il expose 9 outils, comme query, document_names, search_mode.
Résumé généré à partir du README du projet
À propos du MCP server Soracom Knowledge
Ce MCP server permet aux développeurs qui conçoivent des solutions IoT d'ancrer leurs agents IA dans la documentation officielle de Soracom. En se connectant à ce point de terminaison distant en lecture seule via le transport HTTP, des clients tels que Claude Code ou OpenAI Codex peuvent accéder aux guides de service, aux références API et aux recettes IoT. Cela évite que les agents ne se fient uniquement à des données d'entraînement obsolètes en leur offrant un accès en temps réel aux spécifications techniques.
Le serveur propose trois outils spécifiques : search_soracom_docs pour trouver des aperçus de services et des tarifs, search_api_docs pour rechercher des commandes CLI, des permissions SAM et des points de terminaison API, et get_document pour récupérer le contenu Markdown complet d'une page spécifique. Les utilisateurs peuvent choisir entre des modes de recherche par mots-clés, sémantique ou hybride pour affiner leurs résultats.
Comme le serveur utilise la recherche sémantique, les requêtes sont traitées à l'aide des embeddings OpenAI. La configuration est simple pour les clients distants, ne nécessitant que le point de terminaison HTTPS. Il est conçu pour la lecture d'informations publiques uniquement et n'a pas la capacité de modifier les ressources d'un compte Soracom ou les données utilisateur.
Ce que vous pouvez faire avec
- 1Récupérer les spécifications API officiellesDemandez à un agent IA de trouver la méthode HTTP et le chemin spécifiques pour un point de terminaison de service Soracom.
- 2Consulter les guides d'implémentation IoTDemandez à un agent IA de rechercher des recettes IoT spécifiques pour vous aider à implémenter des solutions de connectivité.
- 3Extraire le contenu complet de la documentationDonnez l'instruction à un agent de lire le texte Markdown complet d'une page de documentation spécifique trouvée lors d'une recherche.
- 4Vérifier les tarifs et les procédures de serviceUtilisez le langage naturel pour trouver des informations concernant les coûts des services Soracom ou les étapes de la console utilisateur.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Soracom Knowledge MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Soracom Knowledge MCP dans Claude Code
$ claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/Installer Soracom Knowledge MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Installer Soracom Knowledge MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"knowledge": {
"type": "http",
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Installer Soracom Knowledge MCP dans VS Code CLI
$ code --add-mcp '{"name":"knowledge","type":"http","url":"https://knowledge-mcp.soracom.com/"}'Installer Soracom Knowledge MCP dans Codex
$ codex mcp add knowledge --url https://knowledge-mcp.soracom.com/Installer Soracom Knowledge MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.knowledge] url = "https://knowledge-mcp.soracom.com/"
Installer Soracom Knowledge MCP dans Gemini CLI
$ gemini mcp add -s user --transport http knowledge https://knowledge-mcp.soracom.com/Installer Soracom Knowledge MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/",
"type": "http"
}
}
}Outils MCP Soracom Knowledge 9
Détectés depuis le READMEquerydocument_namessearch_modelanguagemax_resultstagmethodpathurl
| query | — | |
| document_names | — | |
| search_mode | — | |
| language | — | |
| max_results | — | |
| tag | — | |
| method | — | |
| path | — | |
| url | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblesoracom/mcp is public and reachablegithub.com/soracom/mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-08github.com/soracom/mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 574 msRéussi
README
Voir sur GitHubSoracom 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.
Questions sur Soracom Knowledge MCP
Comment ajouter Soracom Knowledge MCP à Claude Code ?
Exécutez claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/ dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Soracom Knowledge MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Soracom Knowledge MCP fournit-il ?
Il expose 9 outils, dont query, document_names, search_mode, language, max_results.
Ce serveur modifie-t-il mon compte Soracom ?
Non, le serveur est un point de terminaison en lecture seule qui se contente de rechercher et de lire la documentation sans modifier aucune ressource.
L'authentification est-elle requise pour utiliser le serveur ?
Le serveur ne nécessite pas d'authentification par utilisateur car il accède uniquement à la documentation publique.
Quels modes de recherche sont disponibles ?
Vous pouvez utiliser la recherche hybride, qui combine recherche par mots-clés et recherche sémantique, ou choisir entre les modes exclusivement par mots-clés ou exclusivement sémantique.