MMEX MCP服务器
MCP（模型上下文协议）服务器，用于与Money Manager EX数据库交互。
______________________________________________________________________
🌐 西班牙语（西班牙语）文件
所有详细的西班牙语文件和指南可在以下网址查阅： 👉 README_es.md
______________________________________________________________________
需求
- Python 3.10+
- Money Manager EX数据库文件（.mmb）
安装
您可以直接从PyPI安装服务器：
pip install mmex-mcp或使用 uv （推荐）：
uv tool install mmex-mcp配置
设置 MMEX_DB_PATH 指向数据库的环境变量：
export MMEX_DB_PATH=/path/to/your/database.mmb对于加密数据库，还设置 MMEX_DB_KEY:
export MMEX_DB_KEY=your_password与MCP客户端一起使用
开源代码
{
"mcp": {
"mmex-mcp": {
"enabled": true,
"type": "local",
"command": [
"mmex-mcp"
],
"environment": {
"MMEX_DB_PATH": "/path/to/your/database.mmb"// Optional
}
}
}
}克劳德桌面
自从 mmex-mcp 作为系统包安装或通过 uv tool，您可以配置Claude Desktop直接使用它。
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"mmex-mcp": {
"command": "mmex-mcp",
"env": {
"MMEX_DB_PATH": "/path/to/your/database.mmb"//Optional
}
}
}
}其他MCP客户端
对于支持stdio MCP服务器的客户端：
MMEX_DB_PATH=/path/to/file.mmb mmex-mcp测试
使用MCP检查器（推荐）
MCP检查器提供了一个web UI，用于交互式测试所有工具：
MMEX_DB_PATH=/path/to/file.mmb npx @modelcontextprotocol/inspector mmex-mcp这将：
- 启动MCP服务器
- 启动MCP检查器web UI
- 在提供的localhost URL上打开浏览器。
可用工具
| 类别 | 工具 |
|---|---|
| 支持 | mmex_support_get_db_version |
| 货币 | mmex_currencies_list, mmex_currencies_get, mmex_currencies_by_symbol, mmex_currencies_create, mmex_currencies_update, mmex_currencies_delete |
| 标签 | mmex_tags_list, mmex_tags_get, mmex_tags_create, mmex_tags_update, mmex_tags_delete, mmex_tags_for_reference, mmex_tags_link, mmex_tags_unlink |
| 分类 | mmex_categories_list, mmex_categories_get, mmex_categories_subcategories, mmex_categories_create, mmex_categories_update, mmex_categories_delete |
| 收款人 | mmex_payees_list, mmex_payees_get, mmex_payees_create, mmex_payees_update, mmex_payees_delete |
| 账户 | mmex_accounts_list, mmex_accounts_get, mmex_accounts_balance, mmex_accounts_create, mmex_accounts_update, mmex_accounts_update_partial, mmex_accounts_delete |
| 资产 | mmex_assets_list, mmex_assets_get, mmex_assets_create, mmex_assets_update, mmex_assets_delete |
| 股票 | mmex_stocks_list, mmex_stocks_get, mmex_stocks_create, mmex_stocks_update, mmex_stocks_delete |
| 交易 | mmex_transactions_list, mmex_transactions_get, mmex_transactions_create, mmex_transactions_update, mmex_transactions_delete, mmex_transactions_splits, mmex_transactions_add_split, mmex_transactions_update_split, mmex_transactions_delete_split, mmex_transactions_tags, mmex_transactions_link_tag, mmex_transactions_unlink_tag |
| 预定 | mmex_scheduled_list, mmex_scheduled_get, mmex_scheduled_create, mmex_scheduled_update, mmex_scheduled_delete |
总计：60个工具
文档
看 docs/ 详细文档：
- docs/README.md -概述
- docs/design.md -技术设计
- docs/implementation-plan.md -实施细节
- docs/README_es.md -概述（西班牙语）
- docs/design_es.md -技术设计（西班牙语）
- docs/implementation-plan.es.md -实施计划（西班牙语）
发展
如果你想从源代码进行贡献或构建：
git clone https://github.com/PatricioRios/mmex_mcp
cd mmex_mcp
uv sync
MMEX_DB_PATH=/path/to/file.mmb uv run mcp dev src/mmex_mcp/server.py