njupt-mcp/docs/kimi-cli-setup.md

Kimi Code CLI 配置指南

本文档介绍如何在 Kimi Code CLI 中配置和使用 NJUPT MCP Server。

配置步骤

1. 找到配置文件

Kimi Code CLI 的配置文件通常位于：

• Windows: %APPDATA%\kimi-cli\config.toml
• macOS/Linux: ~/.config/kimi-cli/config.toml

2. 添加 MCP 服务器配置

stdio 模式（推荐）

[mcp.servers.njupt-mcp]
type = "stdio"
command = "uv"
args = ["run", "--directory", "E:\\Code\\njupt-mcp", "njupt-mcp"]

如果使用 pip 安装：

[mcp.servers.njupt-mcp]
type = "stdio"
command = "python"
args = ["-m", "njupt_mcp.server"]

SSE 模式

首先启动服务器：

cd /path/to/njupt-mcp
uv run njupt-mcp --transport sse --port 8000

然后在配置文件中添加：

[mcp.servers.njupt-mcp]
type = "sse"
url = "http://localhost:8000/sse"

3. 验证配置

在 Kimi Code CLI 中输入：

/mcp

你应该能看到 njupt-mcp 服务器已列出。

使用示例

配置完成后，你可以在 Kimi Code CLI 中这样使用：

> 帮我查一下南京邮电大学数据结构的课程信息

Kimi Code CLI 会自动调用 search_course 工具。

> 帮我查一下学号 B21010101 的课表

这会调用 get_course_schedule 工具。

故障排查

服务器无法启动

1. 检查 Python 版本：python --version 应 >= 3.11
2. 检查依赖是否安装：uv sync 或 pip install -e "."
3. 检查路径是否正确：确保 --directory 指向正确位置

MCP 命令无响应

1. 检查 Kimi Code CLI 版本：kimi --version
2. 查看 Kimi Code CLI 日志，通常在 %APPDATA%\kimi-cli\logs\
3. 尝试手动运行服务器命令，查看是否有错误输出

工具调用失败

1. 确保服务器已正确启动
2. 检查工具参数是否正确
3. 查看服务器日志输出

进阶配置

环境变量

你可以在配置中设置环境变量：

[mcp.servers.njupt-mcp]
type = "stdio"
command = "uv"
args = ["run", "--directory", "E:\\Code\\njupt-mcp", "njupt-mcp"]
env = { NJUPP_API_KEY = "your-api-key", DEBUG = "1" }

多个实例

你可以配置多个服务器实例，分别用于不同环境：

[mcp.servers.njupt-mcp-dev]
type = "stdio"
command = "uv"
args = ["run", "--directory", "E:\\Code\\njupt-mcp", "njupt-mcp", "--debug"]

[mcp.servers.njupt-mcp-prod]
type = "sse"
url = "https://njupt-mcp.your-domain.com/sse"