Skip to main content
Glama
Chisel Knowledge MCP

Chisel Knowledge MCP

by teknologika

chisel-knowledge-mcp

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

Canonical behavior documentation lives in docs/chisel-knowledge-mcp.md and is routed from docs/CANONICAL_DOCS.md.

Requirements

  • Node.js 22 or newer

  • npm

Related MCP server: Notemd MCP Server

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.

Workspace Workflow

The workspace service and MCP server expose a deterministic inbox pipeline:

  • knowledge_get_next_inbox_file returns the first unprocessed inbox file with its content.

  • knowledge_get_dedupe_context returns search results from both knowledge/ and inbox/ for a file-specific query.

  • knowledge_compile_new writes a new article into knowledge/, updates knowledge/index.md, appends knowledge/log.md, and archives the source inbox file.

  • knowledge_compile_extend writes a revised article into knowledge/, updates the article's Updated entry in knowledge/index.md, appends knowledge/log.md, and archives the source inbox file.

These tools are deterministic. The LLM that consumes the MCP server decides the article content and the dedupe outcome; the server only performs file and index updates.

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.

Available Tools

11 tools
knowledge_archiveC

Move a processed inbox file to inbox/archived/.

Inputs: workspace (required), file (required).

knowledge_ingest_clipboardC

Read clipboard text and write it into a workspace inbox.

Inputs: workspace (required), title.

knowledge_ingest_textC

Write raw text into a workspace inbox.

Inputs: workspace (required), content (required), title.

knowledge_ingest_urlC

Ingest a URL into a workspace inbox.

Inputs: workspace (required), url (required), title.

knowledge_listC

List markdown files in a workspace knowledge directory.

Inputs: workspace (required), directory.

knowledge_list_inboxC

List uncompiled files in a workspace inbox.

Inputs: workspace (required).

knowledge_list_workspacesB

List configured workspaces.

Inputs: no named parameters.

knowledge_readC

Read a knowledge file from a workspace.

Inputs: workspace (required), path (required).

knowledge_workspace_statusC

Inspect a workspace.

Inputs: workspace (required).

knowledge_writeC

Write a compiled article into the workspace knowledge directory.

Inputs: workspace (required), path (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: ingest tools handle different input sources (clipboard, text, URL), list tools target different directories (inbox, knowledge, workspaces), and read/write/search/archive/status tools perform unique operations. An agent can easily differentiate them based on their specific actions and targets.

    Naming Consistency5/5

    All tools follow a consistent 'knowledge_verb_noun' pattern (e.g., knowledge_ingest_url, knowledge_list_inbox, knowledge_search). This uniform naming convention makes the tool set predictable and easy to navigate, with no deviations in style or structure.

    Tool Count5/5

    With 11 tools, the server is well-scoped for knowledge management, covering ingestion, organization, querying, and maintenance. Each tool earns its place by addressing a specific need in the workflow, from input handling to file management and search, without being overly sparse or bloated.

    Completeness5/5

    The tool set provides complete coverage for knowledge management: ingestion from multiple sources (clipboard, text, URL), listing and reading files, searching content, writing compiled articles, archiving processed items, and workspace inspection. There are no obvious gaps, enabling agents to handle the full lifecycle of knowledge processing.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to manage a personal markdown-based knowledge base with natural language interactions. Supports creating, searching, updating, and organizing notes across categories like people, recipes, meetings, and procedures.
      11
      1
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to capture bookmarks, sticky notes, todos, notes, and web archives, and to search and organize personal knowledge and memory across cloud-synced clients.
      -