Soracom Knowledge MCP sunucusu
Commit 8 Eki 2026AI agent'larının yanıtlarını resmi dokümantasyonla temellendirmesi için Soracom servis kılavuzlarını, API referanslarını, IoT tariflerini ve CLI komutlarını taramasını sağlar.
Ayrıca bilinen adı soracom/mcp, knowledge
- Yıldızlar
- 4
- Araçlar
- 9
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.1.5
- Son commit
- 8 Eki 2026
- Lisans
- MIT
Soracom Knowledge MCP nedir?
Soracom Knowledge bir MCP sunucusudur. AI agent'larının yanıtlarını resmi dokümantasyonla temellendirmesi için Soracom servis kılavuzlarını, API referanslarını, IoT tariflerini ve CLI komutlarını taramasını sağlar. 9 araç sunar; örneğin query, document_names, search_mode.
Özet, projenin README dosyasından oluşturuldu
Soracom Knowledge MCP sunucusu hakkında
Bu MCP server, IoT çözümleri geliştiren yazılımcıların AI agent'larını resmi Soracom dokümantasyonu ile temellendirmesine olanak tanır. Claude Code veya OpenAI Codex gibi istemciler, HTTP transport üzerinden bu uzak ve salt okunur uç noktaya bağlanarak servis kılavuzlarına, API referanslarına ve IoT tariflerine erişebilir. Bu sayede agent'ların yalnızca güncelliğini yitirmiş eğitim verilerine güvenmesinin önüne geçilir ve teknik spesifikasyonlara gerçek zamanlı erişim sağlanır.
Server üç spesifik araç sunar: servis özetlerini ve fiyatlandırmayı bulmak için search_soracom_docs, CLI komutlarını, SAM izinlerini ve API uç noktalarını aramak için search_api_docs ve belirli bir sayfanın tam Markdown içeriğini getirmek için get_document. Kullanıcılar sonuçlarını netleştirmek için anahtar kelime, semantik veya hibrit arama modları arasında seçim yapabilir.
Server semantik arama kullandığı için sorgular OpenAI embeddings kullanılarak işlenir. Uzak istemciler için kurulum oldukça basittir ve yalnızca HTTPS endpoint gerektirir. Yalnızca halka açık bilgileri okumak üzere tasarlanmıştır; herhangi bir Soracom hesap kaynağını veya kullanıcı verisini değiştirme yeteneğine sahip değildir.
Neler yapabilirsiniz
- 1Resmi API spesifikasyonlarını getirinBir AI agent'ından bir Soracom servis uç noktası için belirli HTTP metodunu ve yolunu (path) bulmasını isteyin.
- 2IoT uygulama kılavuzlarına danışınBağlantı çözümlerinin uygulanmasına yardımcı olması için bir AI agent'ına belirli IoT tariflerini aratın.
- 3Tam dokümantasyon içeriğini çıkarınBir agent'a, arama sırasında bulunan belirli bir dokümantasyon sayfasının tam Markdown metnini okumasını söyleyin.
- 4Servis fiyatlandırmasını ve prosedürlerini kontrol edinSoracom servis maliyetleri veya Kullanıcı Konsolu adımları hakkındaki bilgileri bulmak için doğal dil kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Soracom Knowledge MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleSoracom Knowledge MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/Soracom Knowledge MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Soracom Knowledge MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"knowledge": {
"type": "http",
"url": "https://knowledge-mcp.soracom.com/"
}
}
}Soracom Knowledge MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"knowledge","type":"http","url":"https://knowledge-mcp.soracom.com/"}'Soracom Knowledge MCP'yi Codex içine yükleyin
$ codex mcp add knowledge --url https://knowledge-mcp.soracom.com/Soracom Knowledge MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.knowledge] url = "https://knowledge-mcp.soracom.com/"
Soracom Knowledge MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http knowledge https://knowledge-mcp.soracom.com/Soracom Knowledge MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com/",
"type": "http"
}
}
}Soracom Knowledge MCP araçları 9
README dosyasından algılandıquerydocument_namessearch_modelanguagemax_resultstagmethodpathurl
| query | — | |
| document_names | — | |
| search_mode | — | |
| language | — | |
| max_results | — | |
| tag | — | |
| method | — | |
| path | — | |
| url | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirsoracom/mcp is public and reachablegithub.com/soracom/mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-08github.com/soracom/mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 574 msGeçti
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 soruları
Soracom Knowledge MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com/ komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Soracom Knowledge MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Soracom Knowledge MCP hangi araçları sunar?
9 araç sunar; bunlar arasında query, document_names, search_mode, language, max_results yer alır.
Bu server Soracom hesabımı değiştirir mi?
Hayır, server yalnızca dokümantasyonu arayan ve okuyan, kaynaklarda herhangi bir değişiklik yapmayan salt okunur bir uç noktadır (endpoint).
Server'ı kullanmak için kimlik doğrulaması gerekiyor mu?
Server yalnızca halka açık dokümantasyona eriştiği için kullanıcı başına kimlik doğrulaması gerektirmez.
Hangi arama modları mevcuttur?
Anahtar kelime ve semantik aramayı birleştiren hibrit aramayı kullanabilir veya yalnızca anahtar kelime ya da yalnızca semantik modları arasında seçim yapabilirsiniz.