Kimi MCP Server

Kimi MCP 服务器

直接在Claude Code中获得Kimi K2务实的技术视角。

示例用法：评审、架构决策和技术讨论。

快速开始

1. 获取API密钥: 登月AI 或 OpenRouter （免费套餐）
2. 安装: git clone && cd kimi-mcp-server && npm run setup
3. 使用：打开克劳德代码，键入 /kimi 或 /kimi-plan

所得

Claude代码工具：

• /kimi -从务实的角度看待技术决策
• /kimi-plan -技术方案的架构审查

配置

安装脚本将要求您选择：

选项1：登月AI（直接）

• API密钥： 在这里买你的
• 型号： kimi-k2-0711-preview
• 需要付费帐户

选项2:OpenRouter（推荐）

• API密钥： 在这里买你的
• 型号： moonshotai/kimi-k2:free
• 免费套餐可用

手动设置

如果您更喜欢手动配置：

1.安装依赖项

npm install
npm run build

2.设置环境变量

# For Moonshot AI
export KIMI_API_KEY=your_key_here
export KIMI_API_URL=https://api.moonshot.ai/v1
export KIMI_API_MODEL=kimi-k2-0711-preview

# For OpenRouter (free tier)
export KIMI_API_KEY=your_key_here
export KIMI_API_URL=https://openrouter.ai/api/v1
export KIMI_API_MODEL=moonshotai/kimi-k2:free

3.向Claude注册

# User scope (recommended)
claude mcp add --scope user kimi-server node $(pwd)/dist/server.js

# Project scope (team shared)
claude mcp add --scope project kimi-server node $(pwd)/dist/server.js

命令

• npm run setup -交互式设置（推荐）
• npm run remove -从克劳德代码中删除
• npm run build -构建TypeScript
• npm start -本地测试

环境变量

创建一个 .env 文件或设置环境变量：

KIMI_API_KEY=your_api_key_here          # Required
KIMI_API_URL=https://api.moonshot.ai/v1 # Optional, defaults shown
KIMI_API_MODEL=kimi-k2-0711-preview    # Optional, defaults shown

在系统上的任何位置使用custom.env：

通过系统KIMI_env_FILE变量侧载自定义环境

export KIMI_ENV_FILE=/absolute/path/to/custom/.env

使用示例

代码审查

/kimi Should we use React Context or Redux for state management in a small app?

建筑评论

/kimi-plan 
We're building a microservices architecture:
- API Gateway (Kong)
- Auth Service (JWT)
- User Service (Node.js + PostgreSQL)
- Notification Service (Redis + WebSockets)

故障排除

API密钥不工作？

• 在提供商的控制台上验证密钥
• 检查环境： echo $KIMI_API_KEY

命令未显示？

• 重新启动Claude代码
• 检查注册： claude mcp list
• 重新运行安装程序： npm run setup

安装失败？

• 确保Node.js 18+： node --version
• 如果缺少Claude CLI，请安装
• 检查项目目录中的权限

发展

项目结构

src/
├── config/
│   ├── defaults.ts    # Default configuration
│   └── env.ts         # Environment loading
├── tools/
│   ├── kimi-argue.ts      # Technical discussion
│   └── kimi-review-plan.ts # Architecture review
└── server.ts          # Main MCP server

scripts/
├── setup.js           # Interactive setup
└── remove.js          # Removal script

添加工具

1. 创建 src/tools/my-tool.ts
2. 增添 server.ts 工具列表
3. 跑 npm run build
4. 测试用 npm start

重置所有内容

npm run remove        # Remove from Claude
rm -rf dist/ .env     # Clean files
npm run setup         # Fresh start

______________________________________________________________________

需要帮助？

• 登月控制台
• OpenRouter仪表板
• MCP文件