Soracom Knowledge MCP server
Commit 8 Okt 2026Biarkan AI agent mencari panduan layanan, referensi API, resep IoT, dan perintah CLI Soracom untuk memberikan jawaban yang berbasis pada dokumentasi resmi.
Juga dikenal sebagai soracom/mcp, knowledge
- Stars
- 4
- Tools
- 9
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.1.5
- Commit terakhir
- 8 Okt 2026
- Lisensi
- MIT
Apa itu Soracom Knowledge MCP?
Soracom Knowledge adalah MCP server. Biarkan AI agent mencari panduan layanan, referensi API, resep IoT, dan perintah CLI Soracom untuk memberikan jawaban yang berbasis pada dokumentasi resmi. Server ini menyediakan 9 tool, seperti query, document_names, search_mode.
Ringkasan dibuat dari README proyek
Tentang Soracom Knowledge MCP server
MCP server ini memungkinkan developer yang membangun solusi IoT untuk memberikan grounding pada AI agent menggunakan dokumentasi resmi Soracom. Dengan terhubung ke remote endpoint yang bersifat read-only ini melalui HTTP transport, client seperti Claude Code atau OpenAI Codex dapat mengakses panduan layanan, referensi API, dan resep IoT. Hal ini mencegah agent hanya mengandalkan data training yang mungkin sudah usang dengan menyediakan akses real-time ke spesifikasi teknis.
Server ini menyediakan tiga tool spesifik: search_soracom_docs untuk mencari ringkasan layanan dan harga, search_api_docs untuk mencari perintah CLI, izin SAM, dan endpoint API, serta get_document untuk mengambil konten Markdown lengkap dari halaman tertentu. Pengguna dapat memilih antara mode pencarian keyword, semantic, atau hybrid untuk menyempurnakan hasil pencarian.
Karena server ini menggunakan semantic search, query akan diproses menggunakan OpenAI embeddings. Konfigurasinya sangat mudah untuk remote client, hanya memerlukan HTTPS endpoint. Server ini dirancang hanya untuk membaca informasi publik dan tidak memiliki kemampuan untuk mengubah resource akun Soracom atau data pengguna apa pun.
Apa yang bisa Anda lakukan dengannya
- 1Mengambil spesifikasi API resmiMinta AI agent untuk menemukan HTTP method dan path spesifik untuk endpoint layanan Soracom.
- 2Konsultasi panduan implementasi IoTGunakan AI agent untuk mencari resep IoT tertentu guna membantu implementasi solusi konektivitas.
- 3Ekstrak konten dokumentasi lengkapInstruksikan agent untuk membaca teks Markdown lengkap dari halaman dokumentasi spesifik yang ditemukan saat pencarian.
- 4Cek harga layanan dan prosedurGunakan bahasa natural untuk mencari informasi mengenai biaya layanan Soracom atau langkah-langkah di User Console.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Soracom Knowledge MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Soracom Knowledge MCP di Claude Code
$ claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/Instal Soracom Knowledge MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Instal Soracom Knowledge MCP di VS Code
.vscode/mcp.json
{
"servers": {
"knowledge": {
"type": "http",
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Instal Soracom Knowledge MCP di VS Code CLI
$ code --add-mcp '{"name":"knowledge","type":"http","url":"https://knowledge-mcp.soracom.com/"}'Instal Soracom Knowledge MCP di Codex
$ codex mcp add knowledge --url https://knowledge-mcp.soracom.com/Instal Soracom Knowledge MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.knowledge] url = "https://knowledge-mcp.soracom.com/"
Instal Soracom Knowledge MCP di Gemini CLI
$ gemini mcp add -s user --transport http knowledge https://knowledge-mcp.soracom.com/Instal Soracom Knowledge MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/",
"type": "http"
}
}
}Tool Soracom Knowledge MCP 9
Terdeteksi dari READMEquerydocument_namessearch_modelanguagemax_resultstagmethodpathurl
| query | — | |
| document_names | — | |
| search_mode | — | |
| language | — | |
| max_results | — | |
| tag | — | |
| method | — | |
| path | — | |
| url | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkausoracom/mcp is public and reachablegithub.com/soracom/mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-08github.com/soracom/mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 574 msLolos
README
Lihat di 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.
Pertanyaan tentang Soracom Knowledge MCP
Bagaimana cara menambahkan Soracom Knowledge MCP ke Claude Code?
Jalankan claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/ di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Soracom Knowledge MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan Soracom Knowledge MCP?
Server ini menyediakan 9 tool, termasuk query, document_names, search_mode, language, max_results.
Apakah server ini mengubah akun Soracom saya?
Tidak, server ini adalah endpoint read-only yang hanya melakukan pencarian dan membaca dokumentasi tanpa mengubah resource apa pun.
Apakah diperlukan autentikasi untuk menggunakan server ini?
Server ini tidak memerlukan autentikasi per-user karena hanya mengakses dokumentasi publik.
Mode pencarian apa saja yang tersedia?
Anda dapat menggunakan hybrid search yang menggabungkan keyword dan semantic search, atau memilih antara mode keyword-only atau semantic-only.