# AI Company MCP Server

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

[![npm version](https://img.shields.io/npm/v/ai-company-mcp.svg)](https://www.npmjs.com/package/ai-company-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node.js Version](https://img.shields.io/node/v/ai-company-mcp.svg)](https://nodejs.org)

A production-ready [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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

```bash
# 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/`](https://./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](https://./docs/configuration.md) for full options.

## 📖 Documentation

- [Usage Guide](https://./docs/usage.md)
- [Configuration](https://./docs/configuration.md)
- [Architecture](https://./docs/architecture.md)
- [Development](https://./docs/development.md)
- [Troubleshooting](https://./docs/troubleshooting.md)

## 🧪 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](https://LICENSE) for details.