<p align="center"> <img src="nockit.svg" alt="NockIt" width="128"> </p>

Nockit ⚡

A lightweight, low-latency Model Context Protocol (MCP) server for seamless tool execution and context integration.

---

💡 Overview

Nockit MCP bridges the gap between AI assistants (Claude Desktop, Cursor, Zed, etc.) and local development workflows. Built with minimal overhead, it provides fast, reliable tool execution and context bridging over standard input/output (stdio) or HTTP transport layers.

• 🚀 Lightweight & Fast: Zero bloat, optimized for instant startup and low-latency message relay.
• 🔌 Plug & Play: Seamless integration with MCP-compatible clients like Claude Desktop and Cursor.
• 🛠️ Configurable: Simple JSON-based environment configuration.
• Local & Portable: Works offline out of the box.

---

Installation

You can run nockit-mcp directly using npx or install it globally/locally via your favorite package manager:

Using npx (Recommended)

No installation required:

npx nockit-mcp@latest

Global Installation

  npm install -g nockit-mcp
# or
  pnpm add -g nockit-mcp
# or    
  yarn global add nockit-mcp

Local Project Dependency

  npm install nockit-mcp

---

⚡ Quickstart

1. Claude Desktop Integration

Add nockit-mcp to your Claude Desktop configuration file:

• Linux: ~/.config/Claude/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

  JSON {
    "mcpServers": {
        "nockit": {
        "command": "npx",
        "args": [
            "-y",
            "nockit-mcp@latest"
        ],
        "env": {
            "NOCKIT_LOG_LEVEL": "info"
        }
        }
    }
  }

Restart Claude Desktop, and the Nockit tools will be available automatically.

2. Running Locally for Development

If you are developing or testing nockit-mcp locally:

# Clone the repository
git clone [https://github.com/username/nockit.p](https://github.com/username/nockit.p)
cd nockit

# Install dependencies
npm install

# Build the package
npm run build

# Link locally for testing
npm link

---

⚙️ Configuration

nockit-mcp can be customized using environment variables passed during execution or configured in your MCP host client:

Environment Variable	Type	Default	Description
NOCKIT_LOG_LEVEL	string	info	Log verbosity (debug, info, warn, error)
NOCKIT_PORT	number	3000	Port used when running in HTTP/SSE transport mode
NOCKIT_HOST	string	localhost	Host interface binding for HTTP mode

---

Available Tools & Capabilities

List the primary tools or capabilities exposed by your MCP server here.

• ping: Health check tool to verify server readiness and latency.
• get_status: Returns current operational metrics and system status.

---

Testing & Verification

Run the built-in test suite:

npm test

To test the MCP protocol connection locally using the official MCP Inspector:

npx @modelcontextprotocol/inspector npx nockit-mcp

---

License

Distributed under the MIT License. See LICENSE for more information.