Skip to main content
Glama

ICHIGO MCP

A local-first, developer-focused MCP server for Windows.

Current scope (v0.1)

  • Local MCP over stdio (no public network listener).

  • Read-only project discovery and file inspection.

  • Workspace-scoped file creation and edits.

  • Developer command runner with executable allowlist and timeout.

  • Explicit confirmation for overwrites, deletions, and command execution.

  • Manual start only.

Related MCP server: LocalForge MCP

Requirements

  • Windows 10/11

  • Python 3.11+

  • Internet connection for the first dependency install

Quick start

  1. Open PowerShell in this folder.

  2. Install the environment once:

    powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

  3. Configure an MCP-compatible host using the stdio example below.

  4. To launch the server manually for a host/test harness, run:

    powershell -ExecutionPolicy Bypass -File .\scripts\start.ps1

The stdio server is intended to be launched by an MCP-compatible host. Do not run it as a public web service.

Workspace security

By default, ICHIGO MCP can access only the workspace folder inside this project. Put a project there, or add another explicitly trusted absolute path to config.json under allowed_roots.

All file paths are resolved and checked against these roots. Directory traversal and symlink escapes are rejected.

Hybrid permission model

  • Reads and directory listings: allowed automatically inside configured roots.

  • Create new files: allowed inside configured roots.

  • Overwriting existing files, deleting files, and command execution: require confirm=true.

  • Commands are launched without a shell and must use an allowlisted executable.

  • Timeouts and output limits are enforced.

A host may additionally display its own per-tool approval UI. Tool-level confirmation remains enforced by the server.

MCP client configuration

Example for an MCP host that supports stdio. Replace the paths with the actual repository location on your machine.

{
  "mcpServers": {
    "ichigo-mcp": {
      "command": "C:\\path\\to\\desk-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "ichigo_mcp.server"],
      "cwd": "C:\\path\\to\\desk-mcp",
      "env": {
        "ICHIGO_CONFIG": "C:\\path\\to\\desk-mcp\\config.json"
      }
    }
  }
}

Current limitations

This milestone does not yet provide remote access, screenshots, mouse/keyboard control, background startup, or a hosted gateway. Those should be added only after local tools and permission boundaries are tested. Direct ChatGPT connectivity depends on the ChatGPT plan and supported custom MCP connection options.

Development

.\.venv\Scripts\Activate.ps1
python -m pytest
python .\scripts\smoke_test.py

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A local-first MCP server providing guarded access to a workspace with file operations, search, commands, tests, Git helpers, checkpoints, and structured tool results. It supports multiple tool modes and emphasizes security with workspace restrictions and secret blocking.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to interact with a real Windows workspace by providing tools for file operations, code search, Git, command execution, and managing long-running development processes, all under the current user's context.
      1
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to securely inspect, search, edit, build, and test explicitly authorized local development projects over MCP, with sandboxed filesystem access and sensitive-file protection.
      2
      AGPL 3.0