NLX MCP Node.js服务器

一个基于Node.js的服务器实现,用于处理工具请求并通过API调用与NLX应用程序通信。

  • by nlxai
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 nlxai/mcp-nodejs-server

使用说明

MCP NLX Node.js服务器

项目描述

该项目是使用NLX框架的模型上下文协议(MCP)的Node.js服务器实现。它提供了一个可以处理工具请求并通过API调用与NLX应用程序通信的服务器。

配置

克劳德桌面

  1. 打开您的Claude Desktop配置:

    open ~/Library/Application\ Support/Claude/claude_desktop_config.json
    
  2. 添加NLX应用程序配置:

    {
      "mcpServers": {
        "nlx": {
          "command": "npx",
          "args": ["-y", "@nlxai/mcp-nodejs-server"],
          "env": {
            "NLX_API_KEY": "",
            "NLX_APP_URL": ""
          }
        }
      }
    }
    

设置

先决条件

  • Node.js(版本18或更高版本)
  • npm(节点包管理器)

安装

  1. 克隆存储库:
    git clone <repository-url>
    
  2. 导航到项目目录:
    cd nlx-mcp-server
    
  3. 安装依赖项:
    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