Skip to main content
Glama

cint MCP Server (cint-mcp)

License MCP Version cint Edition

Official public Model Context Protocol (MCP) server for cint 0.2.0 (checked against compiler identity d6ebe30d604346afe4a7912c5d6f3ce2b9d401641d361772892b44b9292609ff).

Gives coding agents (Claude Code, Claude Desktop, Cursor, Windsurf, Copilot, etc.) instant in-memory access to:

  • Public Specifications (SPEC-00P through SPEC-09P)

  • Diagnostic & Fault Catalogue (C1001 through C9102, E_OVERFLOW, E_ASSERT, etc.)

  • Verified .ci Recipes with cryptographic receipts

  • cint University Curriculum (CU-000.2 through CU-401.2)

  • Native Toolchain Execution (cint_check, cint_eval, cint_test) when a local cint binary is present

Zero external package dependencies — runs on standard Python 3.8+ on Linux, macOS, and Windows.


Quick Setup

1. Claude Code CLI (Local or Cloud Sessions)

You can add this MCP server directly via Git or by cloning the repository:

Method A: Run directly from Git (using uvx)

claude mcp add cint -- uvx --from git+https://github.com/pennyleans/cint-mcp cint-mcp

Method B: In any project using .mcp.json

Add to your project's .mcp.json:

{
  "mcpServers": {
    "cint": {
      "command": "python",
      "args": ["path/to/cint-mcp/cint_mcp_server.py"]
    }
  }
}

Method C: Global Claude Code configuration

claude mcp add cint -- python /path/to/cint-mcp/cint_mcp_server.py

2. Claude Desktop

Add to your claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cint": {
      "command": "python",
      "args": ["F:\\cint-mcp\\cint_mcp_server.py"]
    }
  }
}

3. Cursor / Windsurf

Add to .cursor/mcp.json or windsurf config:

{
  "mcpServers": {
    "cint": {
      "command": "python",
      "args": ["cint_mcp_server.py"]
    }
  }
}

Related MCP server: codebase-chat-mcp

Available Tools

Tool

Parameters

Description

cint_search_docs

query, scope, limit, verbose

Search across specifications, glossary, errata, and university lessons

cint_get_doc

id, verbose

Retrieve a self-contained specification or lesson chunk

cint_lookup_diagnostic

code, verbose

Explain compile error codes (C1001–C9102) or runtime faults (E_OVERFLOW, E_DIVZERO) with repairs

cint_get_recipe

name, verbose

Fetch verified 0.2.0 .ci code recipes (fixed-point-trig, money-ledger, fnv1a-digest, etc.)

cint_list_curriculum

course, verbose

List curriculum lessons across CU-000 to CU-401

cint_check

source

Compile .ci source without running it (cint emit-c) and return its diagnostics

cint_eval

source

Compile and run a program (cint run) and return its output or fault record

cint_test

source

Run the program's test blocks (cint test)

The three execution tools need a local cint: on PATH, named by CINT_PATH, or the newest build under CINT_BUILD/boot/<leg>. CINT_MCP_TIMEOUT sets their time limit in seconds (default 120).


Available Resources

Resource URI

Description

cint://manifest

Public edition SHA-256 hashes and compiler source identity

cint://from-c

Quickstart guide for C programmers

cint://from-python

Quickstart guide for Python and NumPy developers

cint://cheat-sheet

Condensed cint 0.2.0 syntax, types, and rules

cint://refusals

Refused constructs catalogue under SPEC-09P.1


License

Licensed under the Apache License, Version 2.0 with LLVM Exceptions matching the cint project. See LICENSE for details.

Available Tools

8 tools
cint_checkA

Compile cint (.ci) source without running it (cint emit-c) and return its CINT-DIAG-1 diagnostics, or 'compiles'. Needs a local cint (PATH or CINT_PATH); look codes up with cint_lookup_diagnostic.

Inputs: source (required).

cint_evalA

Compile and run a cint (.ci) program (cint run) and return its output, or its CINT-DIAG-1 diagnostic or CINT-FAULT-1 fault record. A program is void main() { ... } or top-level statements. Needs a local cint (PATH or CINT_PATH).

Inputs: source (required).

cint_get_docA

Retrieve one self-contained specification or curriculum chunk by the ID cint_search_docs returns (e.g. 'spec-04p:scope', 'cu-201-04:muldiv').

Inputs: id (required), verbose.

cint_get_recipeB

Fetch a verified cint 0.2.0 code recipe (fixed-point-trig, fixed-point-ln-sqrt, wide-i1024-scaling, svg-generator, fnv1a-digest, money-ledger, kernel-double-buffer) with digest.

Inputs: name (required), verbose.

cint_list_curriculumC

List available cint University lessons (CU-000.2 to CU-401.2).

Inputs: course, verbose.

cint_lookup_diagnosticA

Explain any compile diagnostic (C1001 to C9102) or runtime fault (E_OVERFLOW to E_ASSERT) with before/after fixes.

Inputs: code (required), verbose.

cint_search_docsB

Search across cint 0.2.0 specifications (SPEC-00P to SPEC-09P), GLOSSARY, ERRATA, and University curriculum (CU-000 to CU-401). Compact output by default.

Inputs: query (required), limit, scope, verbose.

cint_testA

Run the test "name" { ... } blocks of cint (.ci) source (cint test) and return one CINT-TEST-1 line per test, with the fault record of each failure. Needs a local cint (PATH or CINT_PATH).

Inputs: source (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct action on a distinct resource: check (compile only), eval (compile+run), test (run test blocks), lookup_diagnostic (explain codes), search_docs vs get_doc (find vs retrieve), get_recipe, list_curriculum. The descriptions explicitly disambiguate the easily confused compile/run/test trio and the search/get doc pair.

    Naming Consistency4/5

    All tools share the cint_ prefix and snake_case, and most follow verb_noun (lookup_diagnostic, get_recipe, list_curriculum, search_docs, get_doc). The bare verbs check, eval, and test deviate slightly from the pattern but remain readable and unambiguous.

    Tool Count5/5

    Eight tools is well-scoped for a language-tooling server: execution (check/eval/test), documentation discovery (search_docs/get_doc), diagnostics explanation, and curated assets (recipes/curriculum). Each tool earns its place with no filler.

    Completeness4/5

    The surface covers the full core workflow of compiling, running, testing, diagnosing, and looking up docs/recipes/lessons. Minor gaps exist (no version/environment info tool, no formatter or project scaffolding), but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to perform hybrid code search, get explanations, analyze relations and impacts, retrieve context packs, and generate documentation across ~45 languages via 17 MCP tools, all powered by a local vector database and LLM.
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables local-first codebase intelligence, allowing chat, search, and audit operations on any repository with file:line citations, and supports offline deterministic modes without an LLM.
      15 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides local-first repository architecture analysis with file-level proof, enabling agents to map codebases, locate implementations, trace call paths, and assess change impact with deterministic evidence.
      4 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables IDEs and coding agents to perform fast deterministic repository queries, symbol and dependency graph navigation, persistent memory recall, skill loading, security scanning, git inspection, and model routing with minimal token usage.
      MIT