Open MCP Server

A modular Model Context Protocol (MCP) server with Prompts, Skills, and Workflows for personal productivity automation.

Features

Core Components

• 6 Prompt Templates - Reusable, parameterizable prompts for common tasks
• 11 Skills - Pre-defined task sequences that compose multiple tools
• 9 Workflows - Multi-step automation pipelines with conditionals and loops
• 15+ Tools - File operations, web scraping, git operations, system info, and AI summarization

Categories

• Productivity: Daily planning, task prioritization, briefings
• Development: Code review, project setup, refactoring guidance
• Research: Topic exploration, document summarization
• Document: File analysis, text summarization, word counting

Quick Start

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Server Resources

Available Tools

Prompt Management

• list_prompts - List all prompts (optional category filter)
• search_prompts - Search prompts by query string
• get_prompt - Get prompt template with parameters
• render_prompt - Render a prompt with parameters
• validate_prompt - Validate prompt parameters
• get_prompt_categories - List all prompt categories

Skills (as Tools)

• summarize_document - Read and summarize a file
• analyze_text - Read and analyze text
• setup_project - Initialize a new project
• daily_briefing - Get daily productivity briefing
• project_status - Get project status report
• And 6 more...

Workflow Execution

• execute_workflow - Execute a workflow by ID with variables

Original Tools

• File: read_file, write_file, list_directory, search_files
• Web: fetch_url, scrape_html
• Dev: git_status, git_log, git_diff, system_info, get_time
• AI: summarize

Configuration

Command-line Arguments

node dist/index.js /path/to/workspace /home/user/documents

Environment Variables

• GOOGLE_GENERATIVE_AI_API_KEY - Required for AI summarization features

Usage with Conductor

Add this MCP server to Conductor:

claude mcp add open-mcp -s user -- node /Users/sdluffy/conductor/workspaces/playground/san-jose/open-mcp/dist/index.js

Or add to your conductor.json:

{
  "mcpServers": {
    "open-mcp": {
      "command": "node",
      "args": ["/Users/sdluffy/conductor/workspaces/playground/san-jose/open-mcp/dist/index.js"]
    }
  }
}

Project Structure

open-mcp/
├── src/
│   ├── index.ts                 # Main entry point
│   ├── core/                    # Core engines
│   │   ├── prompt-manager.ts    # Prompt template management
│   │   ├── skill-executor.ts    # Skill execution engine
│   │   ├── workflow-engine.ts   # Workflow engine with conditionals
│   │   └── registry.ts          # Central component registry
│   ├── prompts/                 # Prompt templates (YAML)
│   │   ├── productivity/
│   │   ├── code/
│   │   └── research/
│   ├── skills/                  # Skill definitions
│   │   ├── categories/
│   │   │   ├── document.ts
│   │   │   ├── development.ts
│   │   │   └── productivity.ts
│   │   └── skills.ts            # Skill registry
│   ├── workflows/               # Workflow definitions
│   │   ├── definitions/
│   │   │   ├── daily-routine.ts
│   │   │   ├── code-review.ts
│   │   │   └── project-setup.ts
│   │   └── workflows.ts         # Workflow registry
│   ├── tools/                   # Original tools
│   ├── types/                   # TypeScript definitions
│   └── utils/                   # Utilities
└── prompts/                     # YAML prompt templates

Forked Dependencies

We maintain forks of key dependencies for customization:

Contributing to Forks

1. Make changes in your fork
2. Open a PR to the upstream repository
3. Reference the open-mcp issue you're solving

Development

# Watch mode
npm run dev

# Build
npm run build

# Run with output
npm run dev:full

Adding New Prompts

Create a YAML file in prompts/{category}/:

id: my_prompt
name: My Prompt
description: Description
category: productivity
template: |
  Your template here with {{variables}}
parameters:
  - name: variable
    type: string
    required: true

Adding New Skills

Create a skill in src/skills/categories/{category}.ts:

export const mySkill: Skill = {
  id: "my_skill",
  name: "My Skill",
  description: "Description",
  category: "my_category",
  tools: [
    { tool: "tool_name", parameters: {...} }
  ],
  inputSchema: { type: "object", properties: {...} },
  outputSchema: { type: "object", properties: {...} }
};

Adding New Workflows

Create a workflow in src/workflows/definitions/{name}.ts:

export const myWorkflow: Workflow = {
  id: "my_workflow",
  name: "My Workflow",
  description: "Description",
  steps: [
    { id: "step1", type: "tool", name: "Step 1", config: {...} }
  ]
};

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         MCP Client (Claude)                     │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      MCP Server (stdio)                         │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │                    Tool Registry                          │  │
│  │  ┌───────────┐ ┌───────────┐ ┌─────────────────────┐     │  │
│  │  │  Prompts  │ │  Skills   │ │     Workflows       │     │  │
│  │  │ (Resource)│ │  (Tools)  │ │      (Tools)        │     │  │
│  │  └─────┬─────┘ └─────┬─────┘ └──────────┬──────────┘     │  │
│  └────────┼─────────────┼──────────────────┼─────────────────┘  │
│           │             │                  │                      │
│  ┌────────┼─────────────┼──────────────────┼─────────────────┐  │
│  │        ▼             ▼                  ▼                  │  │
│  │  ┌─────────┐ ┌─────────────┐ ┌──────────────────┐        │  │
│  │  │ Prompt  │ │   Skill     │ │   Workflow       │        │  │
│  │  │ Manager │ │  Executor   │ │    Engine        │        │  │
│  │  └────┬────┘ └──────┬──────┘ └────────┬─────────┘        │  │
│  │       │              │                  │                  │  │
│  │       ▼              ▼                  ▼                  │  │
│  │  ┌─────────────────────────────────────────────────┐     │  │
│  │  │            Existing Tools                       │     │  │
│  │  │  file-tools | web-tools | dev-tools | ai-tools │     │  │
│  │  └─────────────────────────────────────────────────┘     │  │
│  └───────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

Security

• Path validation with allowed directories whitelist
• Command injection prevention
• Timeout protection on HTTP requests
• Directory traversal attack prevention

License

MIT License - see LICENSE for details

Links

• MCP Specification
• Conductor Documentation
• GitHub Repository