BW

boxpositron/with-context-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

48 stars 5 forks Качество 67 Тренд 13MIT

Улучшенный прием заметок для агентов ИИ с наблюдением.

Обзор

WithContext обеспечивает управление заметками в рамках проекта для агентов ИИ, работающих с Obsidian, позволяя им создавать документацию, отслеживать изменения и организовывать знания по мере их кодирования. Вашему агенту по кодированию ИИ нужно место для хранения документации, заметок о встречах и обновлений проекта. WithContext предоставляет им прямой доступ к вашему хранилище Obsidian с: - Каждый проект получает свою собственную папку, никакого перекрестного загрязнения - Агенты могут обновлять фронтматер, заменять разделы, предустанавливать / добавлять контент - Отслеживать, какие изменения делает агент с помощью changelogs и todos - Встроенные предустановки для поддержания чистоты сводов - Профессиональные шаблоны для согласованной документации 1. Открытые настройки Obsidian → Плагины сообщества → Просмотр 2. Поиск и установка 3. Включите плагин и скопируйте ключ API Добавьте это в конфигурацию MCP вашего клиента AI: Claude Desktop, Cline, Cursor, Windsurf, Continue.dev, GitHub Copilot Ваш агент ИИ теперь имеет доступ к 33+ инструментам для управления заметками в MyVault/Projects/.

Обзор (машинный перевод)

Пусть ваши агенты по кодированию ИИ пишут непосредственно в ваши приложения для заметок. WithContext обеспечивает управление заметками в рамках проекта для агентов ИИ, работающих с Obsidian, позволяя им создавать документацию, отслеживать изменения и организовывать знания по мере их кодирования.

##Почему именно контекст?

Вашему агенту по кодированию ИИ нужно место для хранения документации, заметок о встречах и обновлений проекта. WithContext предоставляет им прямой доступ к вашему хранилище Obsidian с:

Автоматическое сканирование проекта Каждый проект получает свою собственную папку, без перекрестного загрязнения -Умное редактирование - Агенты могут обновлять фронтматер, заменять разделы, предустанавливать/прилагать контент Session Tracking - Отслеживайте, какие изменения производит агент с помощью changelogs и todos Интеллектуальная организация - Встроенные предустановки для поддержания чистоты хранилища ** Система шаблонов** - Профессиональные шаблоны для согласованной документации

** Вы устанавливаете его один раз. Ваш агент по искусственному интеллекту управляет всем остальным.**

Быстрая настройка

###1 Установите плагин Obsidian REST API

  1. Открытые настройки Obsidian → Плагины сообщества → Просмотр 2.Поиск "Local REST API и установка"
  2. Включите плагин и скопируйте ключ API

###2 Установите с помощью контекста

###3 Настройте своего клиента

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

WithContext MCP Server

Let your AI coding agents write directly to your note-taking apps. WithContext provides project-scoped note management for AI agents working with Obsidian, enabling them to create documentation, track changes, and organize knowledge as they code.

Why WithContext?

Your AI coding agent needs a place to store documentation, meeting notes, and project updates. WithContext gives them direct access to your Obsidian vault with:

  • Automatic Project Scoping - Each project gets its own folder, no cross-contamination
  • Smart Editing - Agents can update frontmatter, replace sections, prepend/append content
  • Session Tracking - Track what changes the agent makes with changelogs and todos
  • Intelligent Organization - Built-in presets for keeping vaults clean
  • Template System - Professional templates for consistent documentation

You set it up once. Your AI agent handles the rest.

Quick Setup

1. Install Obsidian REST API Plugin

  1. Open Obsidian Settings → Community Plugins → Browse
  2. Search for “Local REST API” and install
  3. Enable the plugin and copy your API key

2. Install WithContext

npm install -g with-context-mcp

3. Configure Your AI Client

Add this to your AI client’s MCP configuration:

OpenCode (opencode.jsonc):

{
  "mcp": {
    "with-context": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "with-context-mcp"],
      "environment": {
        "OBSIDIAN_API_KEY": "{env:OBSIDIAN_API_KEY}",
        "OBSIDIAN_API_URL": "{env:OBSIDIAN_API_URL}",
        "OBSIDIAN_VAULT": "{env:OBSIDIAN_VAULT}",
        "PROJECT_BASE_PATH": "{env:PROJECT_BASE_PATH}",
      },
      "enabled": true,
    },
  },
}

Other Clients: Claude Desktop, Cline, Cursor, Windsurf, Continue.dev, GitHub Copilot →

4. Set Environment Variables

export OBSIDIAN_API_KEY="your_api_key_here"
export OBSIDIAN_API_URL="https://127.0.0.1:27124"
export OBSIDIAN_VAULT="MyVault"
export PROJECT_BASE_PATH="Projects"

That’s it! Your AI agent now has access to 33+ tools for managing notes in MyVault/Projects/.

What Your Agent Can Do

Once configured, your AI coding agent can:

  • Create and update documentation as it writes code
  • Track changes with automatic changelogs and todos
  • Organize the vault using intelligent presets
  • Edit YAML frontmatter to add tags and metadata
  • Search and update existing notes by content or filename
  • Generate notes from templates for consistent formatting
  • Replace specific sections in markdown files by heading
Открыть полный README на GitHub

Установка

npx -y with-context-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →