# ColabAI MCP Server 🎓⚡

> **Model Context Protocol (MCP) Server for ColabAI**  
> Direct academic citation verification, anti-hallucination paper validation, and multi-source academic search for AI agents and LLM tools (Cursor, Claude Desktop, Windsurf, LangChain, OMP).

---

## 🌟 Overview

The **ColabAI MCP Server** exposes the core academic integrity engine of ColabAI directly to AI coding assistants and autonomous research agents.

When your AI generates academic paper citations, literature syntheses, or bibliography entries, it can use this MCP server to:
1. **Verify Paper Existence:** Concurrently query Crossref, Semantic Scholar, DBLP, and arXiv to detect AI-hallucinated citations.
2. **Resolve Official Metadata:** Retrieve authoritative DOIs, canonical author spellings, published proceedings/journals, and year of publication.
3. **Format Citations:** Instantly generate clean, error-free BibTeX (`@inproceedings` / `@article`), APA, and IEEE citations.
4. **Search Academic Databases:** Search across 200M+ scientific publications directly through tool calls.

---

## 🛠️ Available MCP Tools

### 1. `verify_citation`
Checks if a paper actually exists in peer-reviewed scientific literature.
- **Inputs:** `title` (required), `authors` (optional), `year` (optional), `doi` (optional).
- **Returns:** Verification status (`verified` | `partial_match` | `suspected_hallucination`), confidence score (0–100%), resolved DOI, canonical authors, venue, and full BibTeX entry.

### 2. `search_academic_papers`
Searches top academic indexes (Crossref, Semantic Scholar, DBLP, arXiv).
- **Inputs:** `query` (required), `source` (`all` | `crossref` | `semantic_scholar` | `dblp` | `arxiv`).
- **Returns:** List of matching papers with abstracts, citation counts, and links.

### 3. `format_bibtex`
Generates standardized BibTeX, APA, and IEEE citations for any publication.
- **Inputs:** `title`, `authors`, `venue`, `year`, `doi` (optional), `url` (optional).

---

## 🚀 Installation & Setup

### Prerequisites
- Node.js 18+
- npm / yarn / pnpm

```bash
# 1. Clone repository
git clone https://github.com/AhmedCoolProjects/colab-ai-mcp.git
cd colab-ai-mcp

# 2. Install dependencies & build
npm install
npm run build
```

---

## ⚙️ Configuration in AI Agents & Tools

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "colab-ai": {
      "command": "node",
      "args": ["/absolute/path/to/colab-ai-mcp/dist/index.js"]
    }
  }
}
```

### Cursor (`.cursor/mcp.json`)
```json
{
  "mcpServers": {
    "colab-ai": {
      "command": "node",
      "args": ["/absolute/path/to/colab-ai-mcp/dist/index.js"]
    }
  }
}
```

### Running with NPX
```bash
npx @colab-ai/mcp
```

---

## 👥 Authors & Acknowledgments

- **Lead:** Ahmed Bargady & ColabAI Research Team
- **Institution:** College of Computing, Mohammed VI Polytechnic University (UM6P), Ben Guerir, Morocco.
- **License:** MIT