Ncloud MCP Server
by sjk4425io.github.sjk4425/ncloudv2.0.1
MCP server for Naver Cloud Platform (Ncloud) — Public, Government and Financial zones
context tax
queued
security
queued
cold start
queued
freshness
Active6d ago
Install Ncloud MCP server
Install in Claude Code
claude mcp add ncloud -e NCLOUD_ACCESS_KEY='<ncloud-access-key>' -e NCLOUD_SECRET_KEY='<ncloud-secret-key>' -- npx -y ncloud-mcp-serverInstall in Cursor
{
"mcpServers": {
"ncloud": {
"command": "npx",
"args": [
"-y",
"ncloud-mcp-server"
],
"env": {
"NCLOUD_ACCESS_KEY": "<ncloud-access-key>",
"NCLOUD_SECRET_KEY": "<ncloud-secret-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"ncloud": {
"command": "npx",
"args": [
"-y",
"ncloud-mcp-server"
],
"env": {
"NCLOUD_ACCESS_KEY": "<ncloud-access-key>",
"NCLOUD_SECRET_KEY": "<ncloud-secret-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"ncloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ncloud-mcp-server"
],
"env": {
"NCLOUD_ACCESS_KEY": "<ncloud-access-key>",
"NCLOUD_SECRET_KEY": "<ncloud-secret-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"ncloud": {
"command": "npx",
"args": [
"-y",
"ncloud-mcp-server"
],
"env": {
"NCLOUD_ACCESS_KEY": "<ncloud-access-key>",
"NCLOUD_SECRET_KEY": "<ncloud-secret-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| NCLOUD_ACCESS_KEY | yes | yes | Ncloud API Access Key |
| NCLOUD_SECRET_KEY | yes | yes | Ncloud API Secret Key |
| NCLOUD_ZONE | — | — | Zone: 'pub' (default, Public zone), 'gov' (Government zone) or 'fin' (Financial zone). Selects the API gateways, regions and service catalogue; credentials must be issued by that zone's console. Any other value aborts startup. |
| NCLOUD_REGION | — | — | Ncloud region code. Public zone: KR, JPN, SGN, USWN, DEN. Government zone: KR (KR-CENTRAL), KRS (KR-SOUTH). Financial zone: FKR. Default KR (FKR in the Financial zone). |
| NCLOUD_TOOL_GROUPS | — | — | Comma-separated tool groups to load at startup, e.g. 'compute,network,billing' or 'all,-billing'. Unset = all groups. Include the 'dynamic' keyword to start with the core set (common+compute+network+database) AND allow mid-session expansion via the ncloud_enable_tool_group meta tool; without 'dynamic', the listed groups are locked (no runtime expansion). A '-'-excluded group is also refused for dynamic enable. common is always on. |
| NCLOUD_RESPONSE_PRUNE | — | — | Set to '1' to strip empty values (null/""/[]/{}) from responses globally. |
| NCLOUD_TIMEOUT_MS | — | — | API request timeout in milliseconds (default 30000). HTTP 429 is always auto-retried up to 2 times; read-only query tools also retry 503/504 and network errors. |
| NCLOUD_LANG | — | — | Language for client error messages: 'en' for English, otherwise/unset is Korean (default). |
| NCLOUD_RESPONSE_MAXBYTES | — | — | Opt-in response-size guard for read-only tools. When set to a positive byte threshold, large read-only responses are truncated item-by-item to stay under it, adding 'truncated'/'suggestedPageSize' recovery hints. Unset/0 = guard off (response shape unchanged). |
Freshness
Active — last maintenance signal 6d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-02 · 7d ago · GitHub
Latest release
2026-10-04 · 6d ago · GitHub · v2.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-02 · 7d ago · official registry · v2.0.1
FAQ
›How do I install the Ncloud MCP server in Claude Code?
Run: claude mcp add ncloud -e NCLOUD_ACCESS_KEY='<ncloud-access-key>' -e NCLOUD_SECRET_KEY='<ncloud-secret-key>' -- npx -y ncloud-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Ncloud require an API key?
Yes. It expects NCLOUD_ACCESS_KEY, NCLOUD_SECRET_KEY, of which 2 are secrets.
›Can I use Ncloud as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Ncloud in the official MCP registry?
Yes, as io.github.sjk4425/ncloud.