Skip to main content
Glama
Sign In
ai-company-mcp

ai-company-mcp

by IM-D311
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Related MCP server: skillsmp-mcp-server

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers