Soracom Knowledge MCP server
2026년 10월 8일 커밋AI 에이전트가 Soracom 서비스 가이드, API 레퍼런스, IoT 레시피 및 CLI 명령어를 검색하여 공식 문서를 바탕으로 답변을 생성할 수 있도록 지원합니다.
다른 이름 soracom/mcp, knowledge
- 스타
- 4
- Tools
- 9
- 다운로드, 30일
- —
- 최신 버전
- 1.1.5
- 마지막 커밋
- 2026년 10월 8일
- 라이선스
- MIT
Soracom Knowledge MCP란?
Soracom Knowledge은(는) MCP server입니다. AI 에이전트가 Soracom 서비스 가이드, API 레퍼런스, IoT 레시피 및 CLI 명령어를 검색하여 공식 문서를 바탕으로 답변을 생성할 수 있도록 지원합니다. 9개 도구를 제공합니다. 예: query, document_names, search_mode.
프로젝트 README에서 생성된 요약
Soracom Knowledge MCP server 정보
이 MCP server는 IoT 솔루션을 구축하는 개발자가 AI 에이전트에게 공식 Soracom 문서를 기반으로 한 답변을 제공할 수 있도록 지원합니다. HTTP transport를 통해 원격 읽기 전용 엔드포인트에 연결함으로써, Claude Code 또는 OpenAI Codex와 같은 클라이언트가 서비스 가이드, API 레퍼런스, IoT 레시피에 접근할 수 있습니다. 이를 통해 에이전트가 오래된 학습 데이터에만 의존하지 않고 기술 사양에 실시간으로 접근할 수 있습니다.
서버는 세 가지 특정 도구를 제공합니다. 서비스 개요 및 가격을 찾는 search_soracom_docs, CLI 명령어, SAM 권한 및 API 엔드포인트를 조회하는 search_api_docs, 그리고 특정 페이지의 전체 Markdown 콘텐츠를 가져오는 get_document가 있습니다. 사용자는 검색 결과를 정교화하기 위해 키워드, 시맨틱 또는 하이브리드 검색 모드 중 하나를 선택할 수 있습니다.
서버는 시맨틱 검색을 사용하므로 OpenAI embeddings를 사용하여 쿼리를 처리합니다. 원격 클라이언트를 위한 설정은 간단하며 HTTPS 엔드포인트만 필요합니다. 이 서버는 공개 정보 읽기 전용으로 설계되었으며, Soracom 계정 리소스나 사용자 데이터를 수정할 수 있는 권한이 없습니다.
활용 사례
- 1공식 API 사양 조회AI 에이전트에게 Soracom 서비스 엔드포인트의 특정 HTTP method와 path를 찾도록 요청합니다.
- 2IoT 구현 가이드 참조AI 에이전트가 특정 IoT 레시피를 검색하여 연결 솔루션 구현을 돕도록 합니다.
- 3전체 문서 콘텐츠 추출검색 중 발견된 특정 문서 페이지의 전체 Markdown 텍스트를 읽도록 에이전트에게 지시합니다.
- 4서비스 가격 및 절차 확인자연어를 사용하여 Soracom 서비스 비용이나 User Console 단계에 관한 정보를 찾습니다.
프로젝트의 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Soracom Knowledge MCP는 어떤 도구를 제공하나요?
9개 도구를 제공합니다. 예: query, document_names, search_mode, language, max_results.
이 서버가 제 Soracom 계정을 수정할 수 있나요?
아니요, 이 서버는 읽기 전용 엔드포인트로, 리소스를 수정하지 않고 문서 검색 및 읽기 작업만 수행합니다.
서버 사용을 위해 인증이 필요한가요?
공개된 문서에만 접근하므로 사용자별 인증은 필요하지 않습니다.
어떤 검색 모드를 사용할 수 있나요?
키워드 검색과 시맨틱 검색을 결합한 하이브리드 검색을 사용할 수 있으며, 키워드 전용 또는 시맨틱 전용 모드를 선택할 수도 있습니다.