Pathfinder

Provides an MCP server workflow for research, planning, and implementation with session management and templates.

typescript

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jamesctucker-pathfinder-mcp": {
      "command": "uvx",
      "args": [
        "pathfinder-mcp"
      ],
      "env": {
        "PATHFINDER_HOST": "127.0.0.1",
        "PATHFINDER_PORT": "8080",
        "PATHFINDER_TRANSPORT": "stdio",
        "PATHFINDER_SESSIONS_DIR": "/Users/yourusername/.pathfinder-sessions"
      }
    }
  }
}

Pathfinder MCP Server provides a three‑phase workflow—Research, Plan, and Implement—with explicit human approvals at each transition. It helps you focus on complex coding tasks by organizing information gathering, structured planning, and progress‑tracked execution in a repeatable, auditable way.

How to use

You connect with Pathfinder MCP Server through an MCP client to drive a session from research through implementation. Start a session to begin gathering research findings, then plan your implementation with an explicit plan, and finally execute the plan while tracking progress. You can compact the session context to keep long runs lightweight and reuse its summaries for future work.

How to install

Prerequisites: you need Node.js installed to run the MCP server via the command line tool, and you may use a local development flow if you plan to modify the server.

Install and run Pathfinder MCP Server in two approaches: a published, direct run and a local development setup.

Configuration

Pathfinder MCP Server exposes its behavior through environment variables and MCP configurations. Use the environment variables to tailor transport, host, ports, and session storage. You can provide multiple MCP configurations to connect via different runtimes or transport methods.

Session structure and artifacts

Each session stores its research notes, planning templates, progress, and a compacted summary in a dedicated directory. This enables you to resume work, audit decisions, and share a clear history of how your implementation evolved.

Development

If you are developing Pathfinder MCP Server locally, you can clone the project, install dependencies, and run the local server for testing and iteration. Use the provided development commands to run tests, lint, and build as you refine the code.

Available tools

health_check

Server health and context status

start_research

Initialize research phase

save_research

Save research findings

start_plan

Transition to planning and create plan template (requires approval)

save_plan

Save the implementation plan

implement_phase

Execute implementation phase and progress tracking

compact_context

Compress session context when utilization is high

Built by

VeilStrat

AI signals for GTM teams