AI Company MCP Server

AI Knowledge & Skills Server — Expose your entire AI knowledge base to any MCP client.

A production-ready Model Context Protocol (MCP) server that acts as your AI knowledge and skills hub. It automatically discovers, indexes, and serves your skill library to any MCP-compatible client.

✨ Features

• 🔍 Automatic Skill Discovery — Drop folders into knowledge/skills/ and they're instantly available
• 🚀 Full-Text Search — TF-IDF powered search with relevance ranking and filtering
• 📋 Rich Metadata — YAML frontmatter parsing with automatic inference
• 🔄 Hot Reload — File watcher automatically reindexes on changes
• 🛠 17 MCP Tools — List, search, get, recommend, validate, export, and more
• 📚 10 MCP Prompts — Frontend, backend, React, testing, architecture, and more
• 📦 MCP Resources — Browse skills, metadata, categories, tags via resource API
• ⚡ High Performance — In-memory index, caching, lazy loading
• 🌍 Cross-Platform — Windows, Linux, macOS
• 🔒 Runs Locally — No network, no external services, your data stays private

🚀 Quick Start

# Run directly (no installation)
npx ai-company-mcp

Or install globally:

npm install -g ai-company-mcp
ai-company-mcp

📁 Skill Structure

Create skill directories in knowledge/skills/:

knowledge/skills/
└── react-patterns/
    ├── SKILL.md          # Primary file
    └── examples.md       # Additional files

Each skill's markdown file supports YAML frontmatter:

---
name: react-patterns
description: Common React patterns and best practices
category: frontend
tags: [react, patterns, hooks]
priority: high
difficulty: intermediate
---

🔌 Client Configuration

OpenCode

{
  "mcp": {
    "ai-company": {
      "command": "npx",
      "args": ["-y", "ai-company-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "ai-company": {
      "command": "npx",
      "args": ["-y", "ai-company-mcp"]
    }
  }
}

Cursor / VS Code / Windsurf

See examples/ for all client configurations.

🛠 Available Tools

Tool ↕▾	Description ↕▾
−list_skills	List all skills with filtering
−search_skills	Full-text search with ranking
−get_skill	Get complete skill details
−recommend_skills	Find related skills
−list_categories	List all categories
−list_tags	List all tags
−reload_index	Force reindex from disk
−validate_skill	Validate skill structure
−summarize_skill	Generate skill summary
−explain_skill	Detailed skill explanation
−find_related_skills	Tag-based related skills
find_best_skill	Best match for a task
export_skill	Export in markdown/JSON/text
export_index	Export full index as JSON
statistics	Knowledge base stats
health	Server health check
ping	Connectivity check
⚙

⚙️ Configuration

# Environment variables
MCP_SKILLS_PATH=./my-skills
MCP_WATCH_ENABLED=true
MCP_LOG_LEVEL=debug

# CLI arguments
npx ai-company-mcp --skills-path=./my-skills --watch=false

# JSON config file (mcp-config.json)
{
  "skillsPath": "./my-skills",
  "watchEnabled": true,
  "logLevel": "debug"
}

See docs/configuration.md for full options.

📖 Documentation

• Usage Guide
• Configuration
• Architecture
• Development
• Troubleshooting

🧪 Development

git clone <repo-url>
cd ai-company-mcp
npm install
npm run dev       # Hot reload development mode
npm test          # Run tests
npm run build     # Production build

📄 License

MIT — see LICENSE for details.