chisel-knowledge-mcp

Standalone MCP server and library for building and managing knowledge workspaces.

Canonical behavior documentation lives in docs/chisel-knowledge-mcp.md.

Requirements

• Node.js 22 or newer

• npm

Install

npm install

Library usage

Import the workspace service and related types directly from the package root:

import { WorkspaceService, KnowledgeIndex } from '@teknologika/chisel-knowledge-mcp';

The MCP server remains available from the server subpath and through the published binary.

Build

npm run build

Type check

npx tsc --noEmit

Config

The server reads workspace configuration from:

~/.chisel/config.json

If the file does not exist, the server starts with zero configured workspaces and logs a warning to stderr. See config.example.json for the expected shape.

Claude Desktop

Use this MCP server with Claude Desktop by adding:

{
  "mcpServers": {
    "chisel-knowledge": {
      "command": "npx",
      "args": ["-y", "@teknologika/chisel-knowledge-mcp"]
    }
  }
}

Notes

• Transport is stdio only.

• Logging goes to stderr so stdout stays reserved for MCP protocol messages.

• The binary is chisel-knowledge-mcp.

• The package root exports the library surface; @teknologika/chisel-knowledge-mcp/server resolves to the MCP server entry point.