AI Company MCP Server

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

npm version License: MIT Node.js Version

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

🧪 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.