MCP-сервер TickTick
Сервер протокола контекста модели (MCP) для TickTick, который позволяет взаимодействовать с вашей системой управления задачами TickTick напрямую через Claude и другие клиенты MCP.
Функции
- 📋 Посмотрите все ваши проекты и задачи TickTick
- ✏️ Создавайте новые проекты и задачи с помощью естественного языка
- 🔄 Обновите существующие данные задачи (название, содержание, даты, приоритет)
- ✅ Отметить задачи как выполненные
- 🗑️ Удалить задачи и проекты
- 🔄 Полная интеграция с открытым API TickTick
- 🔌 Полная интеграция с Claude и другими клиентами MCP
Предпосылки
- Python 3.10 или выше
- uv - Быстрый установщик и распознаватель пакетов Python
- Аккаунт TickTick с доступом к API
- Учетные данные API TickTick (идентификатор клиента, секрет клиента, токен доступа)
Установка
- Клонируйте этот репозиторий :
git clone https://github.com/jacepark12/ticktick-mcp.git
cd ticktick-mcp
- Установить с помощью uv :
# Install uv if you don't have it already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create a virtual environment
uv venv
# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate
# Install the package
uv pip install -e .
- Аутентификация с помощью TickTick :
# Run the authentication flow
uv run -m ticktick_mcp.cli auth
- Запросите свой идентификатор клиента TickTick и секретный код клиента
- Откройте окно браузера, чтобы войти в TickTick.
- Автоматически сохраняйте ваши токены доступа в файл
.env
- Проверьте свою конфигурацию :Это позволит проверить правильность работы ваших учетных данных TickTick.
Аутентификация с помощью TickTick
Этот сервер использует OAuth2 для аутентификации с TickTick. Процесс настройки прост:
- Зарегистрируйте свое приложение в Центре разработчиков TickTick
- Установите URI перенаправления на
http://localhost:8000/callback - Запишите свой идентификатор клиента и секретный код клиента.
- Запустите команду аутентификации:
uv run -m ticktick_mcp.cli auth
- Следуйте инструкциям, чтобы ввести свой идентификатор клиента и секретный код клиента.
- Откроется окно браузера, в котором вы сможете авторизовать приложение с помощью своей учетной записи TickTick.
- После авторизации вы будете перенаправлены обратно в приложение, а ваши токены доступа будут автоматически сохранены в файле
.env
Сервер автоматически обновляет токены, поэтому вам не придется проходить повторную аутентификацию, если только вы не отзовете доступ или не удалите файл .env .
Аутентификация с помощью Dida365
滴答清单 - Dida365 - это китайская версия TickTick, и процесс аутентификации похож на TickTick. Выполните следующие шаги, чтобы настроить аутентификацию Dida365:
- Зарегистрируйте свою заявку в Центре разработчиков Dida365
- Установите URI перенаправления на
http://localhost:8000/callback - Запишите свой идентификатор клиента и секретный код клиента.
- Добавьте переменные среды в ваш файл
.env :TICKTICK_BASE_URL='https://api.dida365.com/open/v1'
TICKTICK_AUTH_URL='https://dida365.com/oauth/authorize'
TICKTICK_TOKEN_URL='https://dida365.com/oauth/token'
- Выполните те же шаги аутентификации, что и для TickTick.
Использование с Claude для рабочего стола
- Установить Claude для рабочего стола
- Отредактируйте файл конфигурации Claude for Desktop:macOS :
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
notepad %APPDATA%\Claude\claude_desktop_config.json
- Добавьте конфигурацию сервера TickTick MCP, используя абсолютные пути:
{
"mcpServers": {
"ticktick": {
"command": "<absolute path to uv>",
"args": ["run", "--directory", "<absolute path to ticktick-mcp directory>", "-m", "ticktick_mcp.cli", "run"]
}
}
}
- Перезапустить Клода для рабочего стола
После подключения вы увидите инструменты сервера TickTick MCP, доступные в Claude, обозначенные значком 🔨 (инструменты).
Доступные инструменты MCP
| Инструмент | Описание | Параметры |
|---|
get_projects | Перечислите все ваши проекты TickTick | Никто |
get_project | Получите подробную информацию о конкретном проекте | project_id |
get_project_tasks | Перечислите все задачи в проекте | project_id |
get_task | Получите подробную информацию о конкретной задаче | project_id , task_id |
create_task | Создать новую задачу | title , project_id , content (необязательно), start_date (необязательно), due_date (необязательно), priority (необязательно) |
update_task | Обновить существующую задачу | task_id , project_id , title (необязательно), content (необязательно), start_date (необязательно), due_date (необязательно), priority (необязательно) |
complete_task | Отметить задачу как выполненную | project_id , task_id |
delete_task | Удалить задачу | project_id , task_id |
create_project | Создать новый проект | name , color (необязательно), view_mode (необязательно) |
delete_project | Удалить проект | project_id |
Примеры подсказок для Клода
Вот несколько примеров подсказок для использования с Клодом после подключения к серверу TickTick MCP:
- «Покажи мне все мои проекты TickTick»
- «Создать новую задачу под названием «Завершить документацию сервера MCP» в моем рабочем проекте с высоким приоритетом»
- «Список всех задач в моем личном проекте»
- «Отметить задачу «Купить продукты» как выполненную»
- «Создайте новый проект под названием «Планирование отпуска» синего цвета»
- «Когда у меня следующий дедлайн в TickTick?»
Разработка
Структура проекта
ticktick-mcp/
├── .env.template # Template for environment variables
├── README.md # Project documentation
├── requirements.txt # Project dependencies
├── setup.py # Package setup file
├── test_server.py # Test script for server configuration
└── ticktick_mcp/ # Main package
├── __init__.py # Package initialization
├── authenticate.py # OAuth authentication utility
├── cli.py # Command-line interface
└── src/ # Source code
├── __init__.py # Module initialization
├── auth.py # OAuth authentication implementation
├── server.py # MCP server implementation
└── ticktick_client.py # TickTick API client
Поток аутентификации
Проект реализует полный процесс OAuth 2.0 для TickTick:
- Первоначальная настройка : пользователь указывает свой идентификатор клиента API TickTick и секретный ключ.
- Авторизация браузера : пользователь перенаправляется на TickTick для предоставления доступа.
- Прием токена : локальный сервер получает обратный вызов OAuth с кодом авторизации.
- Обмен токенами : код обменивается на токены доступа и обновления.
- Хранилище токенов : токены надежно хранятся в локальном файле
.env - Обновление токена : клиент автоматически обновляет токен доступа по истечении срока его действия.
Это упрощает работу пользователя, поскольку весь процесс OAuth обрабатывается программно.
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
- Форк репозитория
- Создайте ветку функций (
git checkout -b feature/amazing-feature ) - Зафиксируйте свои изменения (
git commit -m 'Add some amazing feature' ) - Отправить в ветку (
git push origin feature/amazing-feature ) - Открыть запрос на извлечение
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.