预算API服务器

YNAB MCP服务器

一个基于Python的MCP（机器可调整的合作计划）服务器，用于与YNAB（你需要预算）API接口。

关于项目

该项目提供了一个服务器，作为客户端应用程序和YNABneneneba API之间的桥梁。它的设计目的是 同时支持stdio和HTTP传输，使其能够灵活地用于各种客户端实现。核心思想是 提供用例驱动的工具，而不是YNAB API端点的直接1对1映射。

我们遵循规范驱动的开发方法。您可以在 docs/ 目录。

入门指南

要启动并运行本地副本，请执行以下简单步骤。

先决条件

• Python 3.12+
• 诗歌
• pyenv （建议用于管理Python版本）

安装

1. 克隆仓库

   复制

   git clone https://github.com/cameri/ynab-mcp-python.git
   cd ynab-mcp-python
   

2. 设置Python版本

   复制

   pyenv install 3.12
   pyenv local 3.12
   

3. 安装依赖项

   复制

   poetry install
   

4. 安装预提交挂钩

   复制

   poetry run pre-commit install
   

用法

服务器可以通过以下任一方式启动 stdio 或 http 运输。

poetry run python src/ynab_mcp_server/main.py --transport stdio

或

poetry run python src/ynab_mcp_server/main.py --transport http

（注：服务器的实现尚未完成。）

贡献

贡献使开源社区成为一个学习、激励和创造的好地方。任何 你所做的贡献是 非常感谢.

请阅读我们的 贡献.md 有关我们的行为准则和提交流程的详细信息 将请求拉给我们。

许可证

根据MIT许可证分发。看 LICENSE 了解更多信息。