MCP-сервери: Notes і Git

Два MCP-сервери для підключення до Claude Desktop. Почав з Notes, але було ще цікаво git спробувати.

Встановлення

Вимоги: Python 3.10+, пакет mcp

pip install mcp

Додати до claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "notes": {
      "command": "python",
      "args": ["шлях/до/notes_server.py"]
    },
    "git": {
      "command": "python",
      "args": ["шлях/до/git_server.py"],
      "env": { "GIT_REPO_PATH": "шлях/до/репозиторію" }
    }
  }
}

Перезапустити Claude Desktop.

---

Notes Server

Зберігає нотатки у ~/.mcp_notes/notes.json.

Tools

Tool	Аргументи	Опис
create_note	title, content (обов'язкові), tags (опційно)	Створити нотатку
update_note	title (обов'язковий), content, tags (опційно)	Оновити нотатку
delete_note	title (обов'язковий)	Видалити нотатку
search_notes	query (обов'язковий), tag (опційно)	Пошук по тексту та тегах

Resources

Resource	Опис
notes://all	Всі нотатки у форматі Markdown
notes://{title}	Одна нотатка за назвою

Приклади діалогів

Створення нотатки:

Збережи нотатку "Покупки" з текстом "Молоко, хліб, яйця, кава" і тегом "особисте".

Пошук:

Знайди всі нотатки з тегом "особисте".

Оновлення:

Онови нотатку "Покупки" — додай до списку "масло".

Обмеження

• Нотатки зберігаються в одному JSON-файлі — не підходить для паралельного запису
• Пошук — простий збіг підрядка, без нечіткого пошуку
• notes://all повертає всі нотатки одразу, без пагінації
• Назви нотаток унікальні — дублікати не допускаються

---

Git Server

Дозволяє переглядати стан репозиторію і робити коміти. Репозиторій задається через GIT_REPO_PATH або аргументом repo_path.

Tools

Tool	Аргументи	Опис
git_status	repo_path (опційно)	Статус робочого дерева
git_log	repo_path, limit (опційно)	Історія комітів
git_diff	repo_path, file (опційно)	Незбережені зміни
git_commit	message (обов'язковий), repo_path, files (опційно)	Зробити коміт

Resources

Resource	Опис
git://log	Останні 10 комітів репозиторію за замовчуванням

Приклади діалогів

Статус:

Який зараз статус репозиторію?

Коміт:

Зроби коміт усіх змін з повідомленням "fix: виправлено валідацію форми".

Перегляд змін:

Покажи що змінилось у файлі main.py.

Обмеження

• Тільки локальні операції — push, fetch, pull не підтримуються
• GIT_REPO_PATH має бути задано — автовизначення директорії відсутнє
• git://log працює лише якщо задано GIT_REPO_PATH, повертає 10 комітів