技术决策辅助工具

Kimi MCP Server是一个集成在Claude Code中的技术决策辅助工具,提供技术讨论、架构审查和代码评审等功能,适用于开发者在技术决策和架构设计时获取实用建议。

  • by brannow
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 brannow/kimi-mcp-server

使用说明

Kimi MCP 服务器

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

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

快速开始

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

所得

Claude代码工具:

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

配置

安装脚本将要求您选择:

选项1:登月AI(直接)

选项2:OpenRouter(推荐)

手动设置

如果您更喜欢手动配置:

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

需要帮助?