Which integrations are available for this server?

Provides tools for Git operations including git_status, git_log, and git_diff to inspect repository status, commit history, and file changes. Integrates with Google Generative AI API for AI-powered summarization features, requiring GOOGLE_GENERATIVE_AI_API_KEY for text summarization capabilities.

How do I use Open MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Open MCP Server summarize the document at /home/user/reports/q3_summary.txt" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Quick Start

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Server Resources

Resource	Description
`prompts://`	List all prompt templates
`prompt://{id}`	Get specific prompt template
`skills://`	List all available skills
`skill://{id}`	Get specific skill details
`workflows://`	List all workflows
`workflow://{id}`	Get specific workflow details
`server-info://`	Server statistics and capabilities

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:

Repository	Fork	Purpose
@modelcontextprotocol/typescript-sdk	ishuru/typescript-sdk	MCP SDK modifications
openai/openai-openapi	ishuru/openai-openapi	OpenAI API spec

Contributing to Forks

Make changes in your fork
Open a PR to the upstream repository
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

Open MCP Server

Open MCP Server

Features

Core Components

Categories

Quick Start

Server Resources

Available Tools

Prompt Management

Skills (as Tools)

Workflow Execution

Original Tools

Configuration

Command-line Arguments

Environment Variables

Usage with Conductor

Project Structure

Forked Dependencies

Contributing to Forks

Development

Adding New Prompts

Adding New Skills

Adding New Workflows

Architecture

Security

License

Links

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API