nia codebase.com
nia codebase.com logo

Nia Codebase

Enables AI to access and understand codebases indexed in Nia's system through a lookup tool that retrieves relevant code...

Created byApr 23, 2025

Nia Codebase MCP

The Nia Codebase MCP server allows you to integrate with Nia's codebase understanding capabilities through function calling in tools like Cursor, Claude Desktop, and other MCP-compatible clients.

Installation

You can use this MCP server without installing it using npx:

Transport Options

The Nia Codebase MCP server supports two transport methods:

1. Standard Input/Output (stdio) - Default

This is the default transport method and is used when no transport is specified:

2. Server-Sent Events (SSE)

To use SSE transport, specify the `--transport=sse` flag and optionally a port (default is 3000):

Usage in MCP Clients

Cursor

  1. Open Cursor Settings > Features > MCP Servers
  1. Add a new MCP server
  1. Name: `nia-codebase`
  1. Type: `command`
  1. Command: `npx -y nia-codebase-mcp@1.0.1 --api-key=YOUR_NIA_API_KEY`

Claude Desktop

Add to your Claude Desktop configuration at `~/Library/Application Support/Claude/claude_desktop_config.json`:
For Windows users, the configuration is at `%APPDATA%\Claude\claude_desktop_config.json`.

Example Prompts

Debugging

If the server isn't working properly, you can enable debug mode:

Environment Variables

You can also configure the server using environment variables:
  • `NIA_API_KEY`: Your Nia API key
  • `TRANSPORT`: The transport method to use (`stdio` or `sse`)
  • `PORT`: The port to use for SSE transport (default: 3000)
  • `TOOL_TIMEOUT_MS`: Custom timeout for tool execution (default: 300000ms)
  • `DEBUG`: Enable debug mode (`true` or `false`)

Tools

This MCP server provides the following tool:
  • **lookup_codebase_context**: Look up context from a codebase indexed in Nia, retrieving relevant code snippets based on user queries.

Requirements

  • Node.js 18 or higher
  • A valid Nia API key
  • A codebase indexed in Nia

License

MIT