What is Nia Mcp

The Nia Codebase MCP is a server that integrates with Nia’s codebase understanding capabilities through function calling. It allows users to analyze and retrieve information from their codebases effectively.

Use cases

Typical use cases include analyzing project structures, understanding authentication systems, retrieving relevant code snippets, and gaining insights into code functionalities to aid developers in their work.

How to use

To utilize the Nia Codebase MCP, you can run it using npx with your Nia API key. Options include using standard input/output or Server-Sent Events for communication. You can also configure it in compatible clients like Cursor or Claude Desktop.

Key features

Key features include support for multiple transport methods (stdio or SSE), a tool for looking up codebase context, environment variable configuration, detailed debugging options, and compatibility with modern MCP clients.

Where to use

The Nia Codebase MCP can be used in tools that support MCP clients, such as Cursor, Claude Desktop, and potentially any development environment that can execute Node.js commands.

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:

npx -y [email protected] --api-key=YOUR_NIA_API_KEY --transport=stdio

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:

npx -y nia-codebase-mcp --api-key=YOUR_NIA_API_KEY

2. Server-Sent Events (SSE)

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

npx -y nia-codebase-mcp --api-key=YOUR_NIA_API_KEY --transport=sse --port=3000

Usage in MCP Clients

Cursor

1. Open Cursor Settings > Features > MCP Servers
2. Add a new MCP server
3. Name: nia-codebase
4. Type: command
5. Command: npx -y [email protected] --api-key=YOUR_NIA_API_KEY

Claude Desktop

Add to your Claude Desktop configuration at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nia-codebase": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "--api-key=YOUR_NIA_API_KEY"
      ]
    }
  }
}

For Windows users, the configuration is at %APPDATA%\Claude\claude_desktop_config.json.

Example Prompts

Using the lookup_codebase_context tool, please analyze my project structure and tell me what the main components are.

Using the lookup_codebase_context tool, search the codebase to understand how the authentication system works and explain its key components.

Debugging

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

npx -y [email protected] --api-key=YOUR_NIA_API_KEY --debug=true

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