本指南将帮助您快速设置并开始使用"天机"思维模型 MCP 服务器。"天机"采用模型上下文协议（Model Context Protocol, MCP）作为通信标准，可与多种支持 MCP 的客户端配合使用。
安装步骤概览
1
系统要求
确认您的系统满足以下最低要求：
- Node.js 18.x 或更高版本
- NPM 7.x 或更高版本
- 至少 50MB 硬盘空间用于思维模型数据库
- 支持 MCP 协议的客户端应用（VS Code, Cursor, Claude 等）
2
选择部署方式
您可以选择以下两种方式部署"天机"服务器：
方式一：使用 NPX 远程启动服务器（推荐）
此方式更简单，无需本地安装完整代码，直接从npm仓库拉取包并运行：
npx --no-cache @thinking-models/mcp-server使用 --no-cache 参数确保每次都获取最新版本
方式二：从源码安装（适合自定义开发）
此方式适合需要自定义开发或修改服务器代码的场景：
# 克隆仓库
git clone https://github.com/lanyijianke/thinking_models_mcp.git
cd thinking_models_mcp
# 安装依赖
npm install
# 编译代码
npm run build
# 启动服务器
node build/thinking_models_server.js3
配置 MCP 客户端
所有客户端都需要通过配置文件（而非UI界面）进行配置，下面是通用配置格式：
方式一：使用 NPX 远程启动配置
{
"mcpServers": {
"thinking-models": {
"command": "npx",
"args": [
"--yes",
"--no-cache",
"@thinking-models/mcp-server@latest"
]
}
}
}方式二：本地运行配置
{
"mcpServers": {
"tianji": {
"command": "node",
"args": [
"您的路径/thinking_models_mcp/build/thinking_models_server.js"
]
}
}
}请将"您的路径"替换为实际的安装路径
4
应用配置到客户端
将上述配置应用到您的客户端中。每个客户端的配置文件位置不同，但格式相同。以下是各客户端的配置指南：
重要提示： 所有客户端均应使用配置文件方式进行配置，而非通过UI界面设置。这样可以确保配置一致且可靠。
5
验证安装
通过客户端发送一个简单请求测试服务器连接是否成功：
请求示例： "天机"当前版本号是多少？
如果配置正确，应该收到一个包含版本信息的响应。
常见安装问题
可能的原因和解决方案：
- 端口冲突：如果使用网络模式，检查端口是否被其他应用占用
- 客户端配置错误：确认客户端中配置的连接 URL 或命令路径正确
- 防火墙限制：检查防火墙是否允许指定端口的通信
尝试重启服务器并使用默认配置，先确认基本连接是否可用。
可能的原因和解决方案：
- 文件权限问题：确保模型目录有读取权限
- 模型文件格式错误：检查自定义模型的 JSON 格式是否正确
- 安装不完整：尝试重新安装服务器以确保所有依赖和数据文件完整
检查服务器日志以获取更详细的错误信息。
可能的原因和解决方案：
- Node.js 版本过低：升级 Node.js 到支持的版本（18.x 或更高）
- 依赖冲突：在一个干净的环境中重新安装
使用 nvm（Node Version Manager）可以轻松切换 Node.js 版本来测试兼容性。