This project is a Node.js server implementation for the Model Context Protocol (MCP) using the NLX framework. It provides a server that can handle tool requests and communicate with an NLX application via API calls.
-
Open your Claude Desktop configuration:
open ~/Library/Application\ Support/Claude/claude_desktop_config.json -
Add the NLX Application configuration:
{ "mcpServers": { "nlx": { "command": "npx", "args": ["-y", "@nlxai/mcp-nodejs-server"], "env": { "NLX_API_KEY": "", "NLX_APP_URL": "" } } } }
- Node.js (version 18 or later)
- npm (Node Package Manager)
- Clone the repository:
git clone <repository-url>
- Navigate to the project directory:
cd nlx-mcp-server - Install the dependencies:
npm install
NLX_APP_URL: The base URL of your NLX application.NLX_API_KEY: The API key for authenticating requests to your NLX application.
To start the server, run the following command:
npm run startThe server will start and listen for requests via standard input/output.
- Module Not Found Errors: Ensure that all dependencies are correctly installed and that the paths in the import statements are correct.
- Environment Variables: Make sure that
NLX_APP_URLandNLX_API_KEYare set correctly in your environment.
- Cannot find module: Verify that the module paths are correct and that the modules are installed.
- Implicit 'any' type: Consider adding TypeScript type definitions to avoid implicit 'any' types.
This project uses semantic-release to automate the versioning and release process. Semantic Release ensures that the version number and changelog are automatically updated based on the commit messages.
Semantic Release uses the Angular commit message conventions. Here is a brief overview of the format:
- feat: A new feature
- fix: A bug fix
- docs: Documentation only changes
- style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
- refactor: A code change that neither fixes a bug nor adds a feature
- perf: A code change that improves performance
- test: Adding missing or correcting existing tests
- chore: Changes to the build process or auxiliary tools and libraries such as documentation generation
To create a new release, simply push your changes to the main branch. The CI/CD pipeline will automatically run semantic-release to determine the next version number, update the changelog, and publish the release.
Ensure your commit messages follow the Angular conventions to trigger the correct version updates.
In dire cicd situations, you can manually trigger a release by running the following command:
npx semantic-release --no-ci