понятие-mcp

Простой сервер Model Context Protocol (MCP), который интегрируется с API Notion для управления моим личным списком дел.

Демо

Related MCP server: Notion MCP Server

Визуальное руководство

Запрос MCP Notion 1

Запрос Notion MCP 2

Запрос Notion MCP 3

Предпосылки

• Python 3.11 или выше

• Учетная запись Notion с доступом к API

• Интеграционный токен Notion

• Страница Notion, на которой вы можете управлять своим списком дел

• Клод Настольный клинт

Настраивать

Установка через Smithery

Чтобы автоматически установить Notion MCP для Claude Desktop через Smithery :

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude

1. Клонируйте репозиторий:

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp

2. Настройте среду Python:

uv venv
source .venv/bin/activate
uv pip install -e .

3. Создайте интеграцию Notion:

   • Перейдите по ссылке https://www.notion.so/my-integrations

   • Создать новую интеграцию

   • Скопируйте ключ API

4. Поделитесь своей базой данных/страницей с интеграцией:

   • Откройте рабочее пространство с базой данных/таблицей или страницей.

   • Нажмите меню «...» → «Добавить соединения».

   • Выберите вашу интеграцию (поиск по имени)

Конфигурация

1. Создайте файл .env :

cp .env.example .env

2. Настройте учетные данные Notion в .env :

NOTION_TOKEN=<your-notion-api-token>
PAGE_ID=<your-notion-page-id>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

3. Чтобы использовать его с Claude Desktop, как задумано, вам нужно настроить файл claude_desktop_config.json . Перейдите в Claude Desktop -> Settings -> Developer -> Edit Config . Теперь добавьте конфигурацию сервера Notion .

{
    "mcpServers": {
        "notion-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/username/Projects/Python/notion-mcp/src" /* Path to your project */,
                "run",
                "server.py"
            ]
        }
    }
}

Разработка

Структура проекта:

notion-mcp/
├── docs/
├── src/
│ └── server.py
├── .env
├── .python-version
├── README.md
├── pyproject.toml
└── uv.lock

Функции поддержки

Показать задачи

Чтобы отобразить все задачи из вашего рабочего пространства Notion, используйте функцию show_all_todos :

{
    "name": "show_all_todos",
    "arguments": {}
}

Добавить задачу

Чтобы добавить новую задачу в рабочее пространство Notion, используйте функцию add_todo :

{
    "name": "add_todo",
    "arguments": {
        "task": "Your task description"
    }
}

Задача обновления

Чтобы обновить существующую задачу в рабочей области Notion, используйте функцию complete_todo :

{
    "name": "complete_todo",
    "arguments": {
        "task_id": "your-task-id"
    }
}

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Отправить запрос на извлечение

Лицензия

Лицензия MIT. Подробности см. в файле LICENSE.