calebl/ynab-mcp-server

Developer tools

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

161 stars 70 forks Качество 85 Тренд 37MIT

Repository Install

calebl/ynab-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/calebl/ynab-mcp-server.

Обзор

calebl/ynab-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/calebl/ynab-mcp-server.

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

Сервер Model Context Protocol (MCP) для взаимодействия с вашими планами YNAB по адресу https://ynab.com

Чтобы ИИ взаимодействовал с этим инструментом, вам нужно получить Personal Access Token от YNAB: https://api.ynab.com/#personal-access-tokens. При добавлении этого MCP-сервера к любому Клиент, вам нужно будет указать свой личный токен доступа как YNAB_API_TOKEN. Этот токен никогда не отправляется напрямую в LLM. Он хранится приватно в переменной среды для использовать с помощью YNAB API.

Сервер протокола Model Context Protocol, который позволяет ИИ ассистент читает и модифицирует план YNAB.

Сервер взаимодействует с YNAB API через официальный ynab SDK. Ваш личный токен доступа живёт в переменной среды и никогда не отправляется в модель.

Он работает двумя способами на основе одного кода:

Локальный (stdio) — дочерний процесс Claude Code или Claude Desktop на вашей Собственная машина. Самая простая, но работает на нём только пока она работает.
Remote (Cloudflare Worker) — развернут за входом на GitHub и добавлен в claude.ai как кастомный коннектор, то есть работает как из веба, так и из мобильного приложения с выключенным компьютером. См. DEPLOY.md.

Обе точки входа регистрируют общие инструменты из 'src/registry.

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

README

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

ynab-mcp-server

A Model Context Protocol (MCP) server for interacting with your YNAB plans at https://ynab.com

In order to have an AI interact with this tool, you will need to get your Personal Access Token from YNAB: https://api.ynab.com/#personal-access-tokens. When adding this MCP server to any client, you will need to provide your personal access token as YNAB_API_TOKEN. This token is never directly sent to the LLM. It is stored privately in an environment variable for use with the YNAB api.

A Model Context Protocol server that lets an AI assistant read and modify a YNAB plan.

The server talks to the YNAB API through the official ynab SDK. Your Personal Access Token lives in an environment variable and is never sent to the model.

It runs two ways from one codebase:

Local (stdio) — a child process of Claude Code or Claude Desktop on your own machine. Simplest, but only works on that machine while it is running.
Remote (Cloudflare Worker) — deployed behind GitHub sign-in and added to claude.ai as a custom connector, so it works from the web and the mobile app with your computer switched off. See DEPLOY.md.

Both entry points register the shared tools from src/registry.ts. The Worker can also run an optional scheduled auto-budget service that records what it would categorize, approve and assign without changing your plan and delivers spending alerts; see Auto-budget service.

Other providers:

Setup

Get a Personal Access Token from , then:

npm install
npm run build

Environment variables:

Variable	Required	Purpose
`YNAB_API_TOKEN`	yes	Personal Access Token used for every API call
`YNAB_PLAN_ID`	no	Default plan, so tools can omit `planId`. Find it with `ynab_list_plans`.
`TYPESAFE_API_KEY`	no	Operator-owned TypeSafe credential. Required, but not sufficient, to enable category suggestions.
`YNAB_AI_CATEGORIZATION`	no	Set to `"true"` together with `TYPESAFE_API_KEY` to expose the opt-in suggestion tool.
`YNAB_AI_TYPICAL_PAYEES`	no	Set to `"true"` to send each category’s most frequent payee names from the last 12 months with each model request. Off by default because it discloses aggregated payee history to TypeSafe.
`YNAB_READ_ONLY`	no	Set to `"true"` (case-insensitive; surrounding whitespace is ignored) to remove tools that write to YNAB, in both the stdio server and the Worker.

Открыть полный README на GitHub

Установка

npx wrangler login`, then create the `OAUTH_KV` namespace

Новичок в MCP? Начните с руководства на mcpskill.org →

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

{
  "mcpServers": {
    "ynab": {
      "command": "node",
      "args": ["/absolute/path/to/ynab-mcp-server/dist/index.js"],
      "env": {
        "YNAB_API_TOKEN": "your-token",
        "YNAB_PLAN_ID": "your-plan-id"
      }
    }
  }
}