Skip to main content
Glama
contactwichit-design

Mindway MCP Server

Mindway MCP Server

Mindway MCP is the canonical context gateway for the Mindway operating protocol. It allows MCP-compatible AI clients (such as Gemini Spark Custom Connected Apps) to read startup context, search public guidelines, and load relevant protocol documentation safely.

  • Canonical Public Entry: https://raw.githubusercontent.com/contactwichit-design/mindway/main/my.md

  • Protocol Endpoint: https://<deployed-domain>/mcp

  • Health Check: GET /health


Capabilities & Tools (Read-Only Version 1)

  1. mindway_load: Load canonical startup context (my.md, README.md, PUBLIC_STANDARD.md).

  2. mindway_get_entry: Retrieve the canonical my.md entry file.

  3. mindway_search_public: Search approved public Markdown files in contactwichit-design/mindway.

  4. mindway_get_file: Read one approved public file with path traversal protection.

  5. mindway_context_bundle: Build a minimal context bundle tailored to a task.

  6. mindway_status: Report server health, version, uptime, and canonical source status.


Related MCP server: MCP Filesystem Server

Security Model

  • Read-Only: Version 1 has zero write, update, delete, or external URL capabilities.

  • Path Traversal Protection: Strictly blocks ../, absolute paths, dotfiles, and secrets.

  • Extension Allowlist: Only .md, .txt, .json, .yaml, .yml, .csv files permitted.

  • Rate Limiting: 100 requests per minute per IP.

  • File Size Caps: 1 MB maximum per file.


Local Setup & Testing

# Install dependencies
npm install

# Build
npm run build

# Run unit tests
npm test

# Run local integration test
npm run test:integration

# Start local server
npm start

Docker Support

docker build -t mindway-mcp .
docker run -p 8080:8080 mindway-mcp

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    A secure Model Context Protocol server that provides controlled filesystem access within predefined directories, enabling AI models to perform file and directory operations with strict path validation.
    16
    3 npm
    7
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides secure filesystem access for AI models through the Model Context Protocol with strict path validation, file operations, directory management, and system command execution within predefined directories.
    16
    3 npm
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides secure, sandboxed file system operations including reading, writing, and managing files within a configurable base directory. It features robust path traversal protection to ensure all file interactions remain confined to a safe, restricted environment.
    -
  • A
    license
    A
    quality
    D
    maintenance
    Efficiently loads, caches, and delivers project file context for AI agents using the Model Context Protocol, reducing multiple file reads to a single call with LRU caching and security validation.
    3
    5 npm
    MIT