nanocode-cli 0.5.12__tar.gz → 0.6.2__tar.gz

{nanocode_cli-0.5.12/nanocode_cli.egg-info → nanocode_cli-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanocode-cli
-Version: 0.5.12
+Version: 0.6.2
 Summary: A small terminal coding agent written in Python
 Author-email: hit9 <hit9@icloud.com>
 License-Expression: BSD-3-Clause
@@ -24,6 +24,7 @@ License-File: LICENSE
 Requires-Dist: anthropic>=0.64.0
 Requires-Dist: code-symbol-index>=0.3.0
 Requires-Dist: json-repair
+Requires-Dist: fastmcp<4,>=3
 Requires-Dist: openai>=2.37.0
 Requires-Dist: prompt-toolkit>=3.0
 Requires-Dist: rich>=13.0
@@ -54,6 +55,7 @@ nanocode is pre-1.0 software. Commands, configuration, and tool behavior may cha
 - **Recoverable context**: Tool output stays bounded in the prompt, while raw `tr.N` results remain recallable.
 - **Cache-aware context**: Stable sections stay early and noisy working state stays late to improve prompt-cache reuse.
 - **Focused working memory**: `Note` separates goal, plan, and known facts from noisy execution logs.
+- **MCP integration**: Connect to remote (HTTP) or local (stdio) Model Context Protocol servers and call their tools.
 - **Terminal-first workflow**: Model selection, history search, confirmations, live command output, appended input, and status all stay in one CLI.
 
 ## Install
@@ -101,6 +103,7 @@ During a running turn, the `+>` prompt accepts follow-up input for the next mode
 - `/debug [on|off]`: toggle model I/O debug traces.
 - `/compact`: compact context now.
 - `/index [force]`: sync or rebuild the code symbol index.
+- `/mcp [tools|login|logout|refresh] ...`: manage MCP servers and tools.
 - `/provider [NAME]`: show or set provider.
 - `/model [MODEL]`: show or set model.
 - `/reason`: choose reasoning effort.
@@ -118,6 +121,7 @@ Interactive selectors support `j`/`k`, arrows, `/` search, Enter, and Esc. Input
 - Shell: `Bash`, `Git`.
 - Tool results: `Recall`.
 - Working notes: `Note`.
+- MCP: `MCP` calls tools on configured MCP servers.
 
 `Read`, `Search`, and `InspectCode` return line anchors where useful. `Edit` uses current `line:hash` anchors to reject stale edits.
 
@@ -140,6 +144,42 @@ Main fields:
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+## MCP
+
+nanocode connects to [Model Context Protocol](https://modelcontextprotocol.io) servers and exposes their tools through the `MCP` tool. Configure each server under `[mcp.<name>]`. A server is either `url` (remote) or `command` (local), never both.
+
+Remote server over streamable HTTP:
+
+```toml
+[mcp.example]
+url = "https://example.com/mcp"
+bearer_token_env_var = "EXAMPLE_MCP_TOKEN"  # optional; sends Authorization: Bearer
+enabled = true
+
+[mcp.oauth_example]
+url = "https://example.com/mcp"
+auth = "oauth"                              # browser login via /mcp login <server>
+enabled = true
+```
+
+Local server over stdio (launched as a subprocess):
+
+```toml
+[mcp.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+env = { SOME_TOKEN = "value" }              # optional; merged over the inherited environment
+enabled = true
+```
+
+The HTTP auth options (`auth`, `bearer_token_env_var`, `env_http_headers`) apply to `url` servers only. `env_http_headers` maps a header name to the environment variable holding its value.
+
+Manage servers at runtime:
+
+- `/mcp`: list configured servers and connection status.
+- `/mcp tools [server]`: list discovered tools.
+- `/mcp refresh [server]`: rediscover servers.
+- `/mcp login <server>` / `/mcp logout <server>`: OAuth login and logout.
 
 ## Tested Providers
 

{nanocode_cli-0.5.12 → nanocode_cli-0.6.2}/README.md

@@ -19,6 +19,7 @@ nanocode is pre-1.0 software. Commands, configuration, and tool behavior may cha
 - **Recoverable context**: Tool output stays bounded in the prompt, while raw `tr.N` results remain recallable.
 - **Cache-aware context**: Stable sections stay early and noisy working state stays late to improve prompt-cache reuse.
 - **Focused working memory**: `Note` separates goal, plan, and known facts from noisy execution logs.
+- **MCP integration**: Connect to remote (HTTP) or local (stdio) Model Context Protocol servers and call their tools.
 - **Terminal-first workflow**: Model selection, history search, confirmations, live command output, appended input, and status all stay in one CLI.
 
 ## Install
@@ -66,6 +67,7 @@ During a running turn, the `+>` prompt accepts follow-up input for the next mode
 - `/debug [on|off]`: toggle model I/O debug traces.
 - `/compact`: compact context now.
 - `/index [force]`: sync or rebuild the code symbol index.
+- `/mcp [tools|login|logout|refresh] ...`: manage MCP servers and tools.
 - `/provider [NAME]`: show or set provider.
 - `/model [MODEL]`: show or set model.
 - `/reason`: choose reasoning effort.
@@ -83,6 +85,7 @@ Interactive selectors support `j`/`k`, arrows, `/` search, Enter, and Esc. Input
 - Shell: `Bash`, `Git`.
 - Tool results: `Recall`.
 - Working notes: `Note`.
+- MCP: `MCP` calls tools on configured MCP servers.
 
 `Read`, `Search`, and `InspectCode` return line anchors where useful. `Edit` uses current `line:hash` anchors to reject stale edits.
 
@@ -105,6 +108,42 @@ Main fields:
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+## MCP
+
+nanocode connects to [Model Context Protocol](https://modelcontextprotocol.io) servers and exposes their tools through the `MCP` tool. Configure each server under `[mcp.<name>]`. A server is either `url` (remote) or `command` (local), never both.
+
+Remote server over streamable HTTP:
+
+```toml
+[mcp.example]
+url = "https://example.com/mcp"
+bearer_token_env_var = "EXAMPLE_MCP_TOKEN"  # optional; sends Authorization: Bearer
+enabled = true
+
+[mcp.oauth_example]
+url = "https://example.com/mcp"
+auth = "oauth"                              # browser login via /mcp login <server>
+enabled = true
+```
+
+Local server over stdio (launched as a subprocess):
+
+```toml
+[mcp.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+env = { SOME_TOKEN = "value" }              # optional; merged over the inherited environment
+enabled = true
+```
+
+The HTTP auth options (`auth`, `bearer_token_env_var`, `env_http_headers`) apply to `url` servers only. `env_http_headers` maps a header name to the environment variable holding its value.
+
+Manage servers at runtime:
+
+- `/mcp`: list configured servers and connection status.
+- `/mcp tools [server]`: list discovered tools.
+- `/mcp refresh [server]`: rediscover servers.
+- `/mcp login <server>` / `/mcp logout <server>`: OAuth login and logout.
 
 ## Tested Providers
 

{nanocode_cli-0.5.12 → nanocode_cli-0.6.2}/README.zh-CN.md

@@ -19,6 +19,7 @@ nanocode 仍是 1.0 前的软件。稳定版发布前，命令、配置和工具
 - **可恢复上下文**：prompt 中的工具输出保持有界，原始 `tr.N` 结果仍可按需召回。
 - **缓存友好上下文**：稳定内容靠前，嘈杂的工作状态靠后，提高 prompt cache 复用率。
 - **聚焦工作记忆**：`Note` 把 goal、plan、known facts 从嘈杂执行日志中拆出来。
+- **MCP 集成**：连接远程（HTTP）或本地（stdio）的 Model Context Protocol 服务器并调用其工具。
 - **终端优先工作流**：模型选择、历史搜索、确认、实时命令输出、追加输入和状态展示都在一个 CLI 内完成。
 
 ## 安装
@@ -66,6 +67,7 @@ nanocode
 - `/debug [on|off]`：切换模型 I/O debug trace。
 - `/compact`：立即压缩上下文。
 - `/index [force]`：同步或重建代码符号索引。
+- `/mcp [tools|login|logout|refresh] ...`：管理 MCP 服务器和工具。
 - `/provider [NAME]`：显示或设置 provider。
 - `/model [MODEL]`：显示或设置模型。
 - `/reason`：选择 reasoning effort。
@@ -83,6 +85,7 @@ nanocode
 - Shell：`Bash`, `Git`。
 - 工具结果：`Recall`。
 - 工作笔记：`Note`。
+- MCP：`MCP` 调用已配置 MCP 服务器上的工具。
 
 `Read`、`Search` 和 `InspectCode` 会在合适时返回行锚点。`Edit` 使用当前 `line:hash` 锚点拒绝过期编辑。
 
@@ -105,6 +108,42 @@ nanocode --init-config
 
 `api = "auto"` 会根据 provider/model profile 在 Chat Completions 和 Anthropic Messages 之间选择。`prompt_cache_key = "auto"` 会根据 provider、model、workspace 和工具 schema 名称生成稳定 key。
 
+## MCP
+
+nanocode 可连接 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，并通过 `MCP` 工具暴露其工具。每个服务器配置在 `[mcp.<name>]` 下，且只能二选一：`url`（远程）或 `command`（本地）。
+
+通过 streamable HTTP 的远程服务器：
+
+```toml
+[mcp.example]
+url = "https://example.com/mcp"
+bearer_token_env_var = "EXAMPLE_MCP_TOKEN"  # 可选；发送 Authorization: Bearer
+enabled = true
+
+[mcp.oauth_example]
+url = "https://example.com/mcp"
+auth = "oauth"                              # 通过 /mcp login <server> 在浏览器登录
+enabled = true
+```
+
+通过 stdio 的本地服务器（作为子进程启动）：
+
+```toml
+[mcp.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+env = { SOME_TOKEN = "value" }              # 可选；会合并到继承的环境变量之上
+enabled = true
+```
+
+HTTP 鉴权选项（`auth`、`bearer_token_env_var`、`env_http_headers`）只对 `url` 服务器生效。`env_http_headers` 把 header 名映射到存放其值的环境变量。
+
+运行时管理服务器：
+
+- `/mcp`：列出已配置服务器及连接状态。
+- `/mcp tools [server]`：列出已发现的工具。
+- `/mcp refresh [server]`：重新发现服务器。
+- `/mcp login <server>` / `/mcp logout <server>`：OAuth 登录和登出。
 
 ## 已测试的 Provider