使用说明
MCP NLX Node.js服务器
项目描述
该项目是使用NLX框架的模型上下文协议(MCP)的Node.js服务器实现。它提供了一个可以处理工具请求并通过API调用与NLX应用程序通信的服务器。
配置
克劳德桌面
-
打开您的Claude Desktop配置:
open ~/Library/Application\ Support/Claude/claude_desktop_config.json -
添加NLX应用程序配置:
{ "mcpServers": { "nlx": { "command": "npx", "args": ["-y", "@nlxai/mcp-nodejs-server"], "env": { "NLX_API_KEY": "", "NLX_APP_URL": "" } } } }
设置
先决条件
- Node.js(版本18或更高版本)
- npm(节点包管理器)
安装
- 克隆存储库:
git clone <repository-url> - 导航到项目目录:
cd nlx-mcp-server - 安装依赖项:
npm install
用法
环境变量
NLX_APP_URL:NLX应用程序的基本URL。NLX_API_KEY:用于对NLX应用程序的请求进行身份验证的API密钥。
运行服务器
要启动服务器,请运行以下命令:
npm run start
服务器将启动并通过标准输入/输出监听请求。
故障排除
常见问题
- 未找到模块错误:确保所有依赖项都已正确安装,并且导入语句中的路径正确。
- 环境变量:确保
NLX_APP_URL和NLX_API_KEY在您的环境中设置正确。
林特尔错误
- 找不到模块:验证模块路径是否正确以及模块是否已安装。
- 隐式“any”类型:考虑添加TypeScript类型定义,以避免隐式的“any”类型。
发布管理
具有语义发布的自动发布
此项目使用 语义释放 使版本控制和发布过程自动化。Semantic Release确保版本号和更改日志根据提交消息自动更新。
提交消息格式
Semantic Release使用Angular提交消息约定。以下是格式的简要概述:
- 合作:新功能
- 修复:错误修复
- 文档:仅文档更改
- 风格:不影响代码含义的更改(空格、格式、缺少分号等)
- 重构:既不修复错误也不添加功能的代码更改
- 性能:提高性能的代码更改
- 测试:添加缺失的测试或更正现有的测试
- 杂务:对构建过程或辅助工具和库(如文档生成)的更改
如何释放
要创建新版本,只需将您的更改推送到 main 支。CI/CD管道将自动运行语义发布,以确定下一个版本号,更新更新日志,并发布发布。
确保你的提交消息遵循Angular约定,以触发正确的版本更新。
在严重的cicd情况下,您可以通过运行以下命令手动触发释放:
npx semantic-release --no-ci