# outline-smart-mcp
## 基本信息
- Slug: `huiseo-outline-smart-mcp`
- Source: modelscope
- Publisher: @huiseo/outline-smart-mcp
- Categories: rag-systems / documentation-access / note-taking
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@huiseo/outline-smart-mcp
## 简介
暂无描述。
## 安装提示

```bash
User: "What's our policy on remote work?" ask_wiki searches your wiki and returns an answer with source links User: "Find documents related to the onboarding guide" find_related returns semantically similar docs (not just keyword matches) User: "Summarize the Q4 planning document" summarize_document generates a concise summary in your preferred language ``` ## Supported Clients | Client | Tools | Resources | Prompts | |--------|:-----:|:---------:|:-------:| | [Claude Desktop](https://claude.ai/download) | | | | | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | | | | | [VS Code GitHub Copilot](https://code.visualstudio.com/) | | | | | [Cursor](https://cursor.sh/) | | - | | | [Windsurf](https://codeium.com/windsurf) | | - | - | | [ChatGPT Desktop](https://chatgpt.com/) | | - | - | ## Getting Started ### Requirements - Node.js 18.0.0 or higher - Outline instance with API access - (Optional) OpenAI API key for smart features ### Getting Your Outline API Token 1. Log in to your Outline instance 2. Go to **Settings** **API** 3. Click **Create API Key** 4. Copy the generated token (starts with `ol_api_`) ### Installation <details> <summary>Claude Desktop</summary> Add to your Claude Desktop configuration: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - Linux: `~/.config/Claude/claude_desktop_config.json` ```json { "mcpServers": { "outline": { "command": "npx", "args": ["-y", "outline-smart-mcp"], "env": { "OUTLINE_URL": "https://your-outline-instance.com", "OUTLINE_API_TOKEN": "…
```

## MCP Server 详情

# Outline Wiki MCP Server

[![npm version](https://img.shields.io/npm/v/outline-smart-mcp.svg)](https://www.npmjs.com/package/outline-smart-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[English](README.md) | [](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)

A Model Context Protocol (MCP) server that enables LLMs to interact with [Outline](https://www.getoutline.com/) wiki through structured API calls. This server provides document management, search, collections, comments, and AI-powered smart features including RAG-based Q&A.

## Why This Server?

Most Outline MCP servers provide basic API wrappers. This one adds optional **Smart Features**:

| Feature | What it does |
|---------|--------------|
| `ask_wiki` | Ask questions in natural language, get answers based on your wiki content (RAG) |
| `find_related` | Find semantically similar documents, not just keyword matches |
| `summarize_document` | Generate summaries of long documents |
| `suggest_tags` | Get tag suggestions based on content analysis |

**When you might need this:**
- Your team's wiki has grown large and search isn't enough
- You want to query your documentation conversationally
- You need semantic search across your knowledge base

**When basic MCP is sufficient:**
- You only need CRUD operations on documents
- You don't want to set up OpenAI API
- Your wiki is small and well-organized

Smart features require `ENABLE_SMART_FEATURES=true` and an OpenAI API key. Without these, the server works as a standard Outline MCP.

### Example Usage

```
User: "What's our policy on remote work?"
 ask_wiki searches your wiki and returns an answer with source links

User: "Find documents related to the onboarding guide"
 find_related returns semantically similar docs (not just keyword matches)

User: "Summarize the Q4 planning document"
 summarize_document generates a concise summary in your preferred language
```

## Supported Clients

| Client | Tools | Resources | Prompts |
|--------|:-----:|:---------:|:-------:|
| [Claude Desktop](https://claude.ai/download) |  |  |  |
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) |  |  |  |
| [VS Code GitHub Copilot](https://code.visualstudio.com/) |  |  |  |
| [Cursor](https://cursor.sh/) |  | - |  |
| [Windsurf](https://codeium.com/windsurf) |  | - | - |
| [ChatGPT Desktop](https://chatgpt.com/) |  | - | - |

## Getting Started

### Requirements

- Node.js 18.0.0 or higher
- Outline instance with API access
- (Optional) OpenAI API key for smart features

### Getting Your Outline API Token

1. Log in to your Outline instance
2. Go to **Settings**  **API**
3. Click **Create API Key**
4. Copy the generated token (starts with `ol_api_`)

### Installation

<details>
<summary>Claude Desktop</summary>

Add to your Claude Desktop configuration:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}
```

</details>

<details>
<summary>Claude Code</summary>

Run the following command:

```bash
claude mcp add outline -e OUTLINE_URL=https://your-outline-instance.com -e OUTLINE_API_TOKEN=ol_api_xxxxxxxxxxxxx -- npx -y outline-smart-mcp
```

Or add to `~/.claude.json` (global) or `.mcp.json` (project-local):

```json
{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}
```

> **Note**: The `~/.claude/settings.json` file is ignored for MCP servers. Use `~/.claude.json` or `.mcp.json` instead.

</details>

<details>
<summary>VS Code GitHub Copilot</summary>

Add to your VS Code settings (`.vscode/mcp.json`):

```json
{
  "servers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}
```

</details>

<details>
<summary>Cursor</summary>

Add to Cursor MCP settings (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}
```

</details>

<details>
<summary>Windsurf</summary>

Add to Windsurf MCP settings (`~/.codeium/windsurf/mcp_config.json`):

```json
{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}
```

</details>

<details>
<summary>ChatGPT Desktop</summary>

ChatGPT supports MCP through its desktop app. Add the server in **Settings**  **MCP Servers** with:

- Command: `npx`
- Arguments: `-y outline-smart-mcp`
- Environment variables as shown above

</details>

## Configuration

### Environment Variables

| Variable | Description | Required | Default |
|----------|-------------|:--------:|---------|
| `OUTLINE_URL` | Your Outline instance URL | Yes | `https://app.getoutline.com` |
| `OUTLINE_API_TOKEN` | Your Outline API token | Yes | - |
| `READ_ONLY` | Enable read-only mode | No | `false` |
| `DISABLE_DELETE` | Disable delete operations | No | `false` |
| `MAX_RETRIES` | API retry attempts | No | `3` |
| `RETRY_DELAY_MS` | Retry delay (ms) | No | `1000` |
| `ENABLE_SMART_FEATURES` | Enable AI features | No | `false` |
| `OPENAI_API_…