ICHIGO MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
Open PowerShell in this folder.
Install the environment once:
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1Configure an MCP-compatible host using the stdio example below.
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.pyTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
A MCP server built for developers enabling Git based project management with project and personal…
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT
- AlicenseAqualityBmaintenanceEnables MCP-compatible AI clients to securely access explicitly authorized local project files and run approved development commands with bounded execution and audit logging.1MIT
- AlicenseNot gradedqualityAmaintenanceEnables 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.2AGPL 3.0