背诵mcp
mcp-name: io.github.rivradev/recite-mcp
recite-mcp 是Recite API的MCP服务器。它为扫描、事务、导入、批处理作业、项目、摘要、Webhook、规则、使用和导出提供了完整的记录在案的Recite MCP界面，同时为希望本地优先记账的代理保留了本地分类账/内存工作流。
安装
最终用户
推荐：
uvx recite-mcp备选方案(pipx):
pipx install recite-mcp备选方案(pip):
python -m pip install recite-mcp贡献者
python -m pip install -e .[dev]
pytest -q
python -m recite_mcp.server所需环境
在获取API密钥 https://recite.rivra.dev/settings/api （包括每月30次免费扫描），然后设置 RECITE_API_KEY （需要处理收据；服务器仍然可以在没有收据的情况下启动，因此 validate_setup() 可以报告缺失的内容）：
# Windows PowerShell
$env:RECITE_API_KEY="re_live_xxx"# macOS/Linux
export RECITE_API_KEY="re_live_xxx"可选家庭覆盖：
# Windows PowerShell
$env:RECITE_HOME="C:\path\to\recite-home"# macOS/Linux
export RECITE_HOME="$HOME/.config/recite"MCP客户端配置
复制粘贴此配置：
{
"mcpServers": {
"recite": {
"command": "uvx",
"args": ["recite-mcp"],
"env": {
"RECITE_API_KEY": "re_live_xxx"
}
}
}
}如果通过安装 pipx 或 pip，使用：
{
"mcpServers": {
"recite": {
"command": "recite-mcp",
"args": [],
"env": {
"RECITE_API_KEY": "re_live_xxx"
}
}
}
}故障排除
MCP注册表所有权验证失败
- 症状：注册表发布返回PyPI所有权/README验证错误。
- 修复：在打包的README中保留这一行：
mcp-name: io.github.rivradev/recite-mcp，然后在发布到注册表之前，更新版本并上传新的PyPI版本。
RECITE_API_KEY 缺失或无效
- 症状：
validate_setup()报告missing_api_key或者拒绝API请求。 - 修复：设置
RECITE_API_KEY在MCP客户端中envconfig（首选）或shell环境。
uvx 命令未找到
- 症状：终端说
uvx未被识别。 - 修复：安装
uv首先，或使用以下选项之一：
- pipx install recite-mcp - python -m pip install recite-mcp
recite-mcp 安装后找不到命令
- 症状：命令后无法识别
pipx/pip安装。 - 修复：
- 对于 pipx：run pipx ensurepath，然后重新打开终端。 - 对于 pip：使用模块入口点运行： python -m recite_mcp.server
MCP客户端已启动，但工具不可用
- 症状：服务器显示已配置，但未列出任何工具/资源。
- 修复：
- 确认MCP配置JSON有效。 - 确认命令和参数与安装方法匹配(uvx 对比 recite-mcp). - 配置更改后重新启动MCP客户端。
无法从PyPI（uvx/pip）下载
- 症状：安装/运行失败，出现网络/代理错误。
- 修复：确保您的环境可以访问PyPI（或配置您的代理/自定义索引）。如果你在一个被锁定的网络上，你可能需要允许PyPI或使用内部镜像。
快速本地验证（无MCP客户端）
- 跑
recite-mcp --validate（或uvx recite-mcp --validate)打印本地配置/健康JSON。退出代码为0如果存在API密钥，否则1.
主要特点
API工具（共41个）：
- 扫描 —
scan_receipt（文件、URL、base64或原始文本；临时模式），get_scan - 交易 --创建、列出（带过滤器）、获取、更新、删除，
import_transactions（JSON列表、CSV文本或CSV文件） - 批量扫描 —
submit_batch_scans（1-20个项目，异步，webhook通知），get_batch_scan_status,get_batch_scan_results - 项目 --列表、创建、更新、删除
- 摘要 —
get_summary（期间、日期范围、分组依据） - 网络钩子 --创建、列出、删除(
transaction.created/updated/deleted,batch.completed) - 和解 —
create_reconciliation_link,list_reconciliation_links,update_reconciliation_link,delete_reconciliation_link,run_auto_match,get_reconciliation_summary,get_reconciliation_recommendations,export_reconciliation - 规则 --创建、列出、更新、删除（供应商类别、默认项目、处理参考）
- 分类 —
get_categories（17个内置+自定义），create_category,delete_category - 供应商 —
get_vendors,create_vendor,delete_vendor - 用法 —
get_usage（期间，细分） - 出口 —
export_transactions（CSV/JSON，可选文件保存）
本地工具：
process_receipt--扫描+分类账一步追加（可选重命名、模拟运行、类别提示）process_receipts_batch--扫描图像/PDF目录（递归、模拟预览）summarize_ledger,export_ledger,add_ledger_correction--本地CSV分类账管理update_memory,list_memory--持久代理指令存储get_config,validate_setup--配置检查和健康检查
资源： recite://ledger, recite://memory, recite://health
文档
- 用户指南：
docs/user_guide.md