TigerPaw MCP 服务器
A. 模型上下文协议（MCP） 为Claude Desktop提供访问TigerPaw API端点的服务器。
语言： TypeScript/Node.js（参考实现）\ 状态： ✅ 正在工作\ 认证： 使用TSI格式的HMAC-SHA256
______________________________________________________________________
🎯 这个的作用
使Claude Desktop能够访问 269 TigerPaw API接口 包括：
- 查询账户、联系人和服务工单
- 访问协议、合同和采购订单
- 检索时间记录、文档和日记条目
- 查阅主表（状态、类型、组等）
- 访问诊断信息和系统信息
- 与克劳德进行全程自然语言对话
______________________________________________________________________
🚀 快速入门
先决条件
- Node.js 已安装18+（内容/软件）（注：这里的“18+”通常指的是包含成人内容或需18岁以上才能访问的内容或软件，具体翻译可能需根据上下文调整）下载)
- TigerPaw API 凭证 （公钥和私钥）
- Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体翻译） 应用程序（app）
安装
- 克隆并安装：
git clone
cd tigerpaw_MCP
npm install- 构建：
npm run build- 配置Claude桌面版：
编辑 %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"tigerpaw": {
"command": "node",
"args": [
"C:\\path\\to\\tigerpaw_MCP\\build\\index.js"
],
"env": {
"TIGERPAW_PUBLIC_KEY": "your-public-key-here",
"TIGERPAW_PRIVATE_KEY": "your-private-key-here",
"TIGERPAW_BASE_URI": "https://restapi.ideanetworks.com"
}
}
}
}- 重启Claude桌面版 完全地
- 测试： 问克劳德：“你有哪些可用的工具？”
______________________________________________________________________
🛠️ 可用工具
269种工具任您选择！
TigerPaw API的所有GET端点都是自动生成的 swagger_get_only.json.
工具类别：
- 一百二十七 通用的GET操作（账户、联系人、服务工单等）
- 九十一 精通主表查询（状态、类型、组别、代表等）
- 23 服务订单操作
- 十三 采购订单操作
- 10 定价操作
- 3 时间日志操作
- 二 诊断和验证工具
示例工具：
账户
tp_get_account_summary- 通过账号获取账户概要tp_get_accounting_details- 获取账户的会计详情tp_get_account_documents- 获取账户文件tp_get_account_journal_entries- 获取日记账条目
服务订单
tp_get_service_order_summary- 通过编号获取服务订单tp_get_service_order_details- 获取详细的服务订单信息tp_get_service_order_time_entries- 获取时间记录
联系人
tp_get_contact_summary- 通过联系电话获取联系人信息tp_get_contacts_for_account- 获取账户的所有联系人tp_get_contact_email_addresses- 获取电子邮件地址
主表
tp_master_tables__get_account_statuses- 获取账户状态tp_master_tables__get_reps- 招募销售代表tp_master_tables__get_service_order_types- 获取服务订单类型
见 TOOLS_SUMMARY.md 以下是全部269个工具的完整列表。
______________________________________________________________________
📁 项目结构
tigerpaw_MCP/
├── src/
│ ├── index.ts # TypeScript server source
│ └── generated_tools.ts # Auto-generated tool definitions
├── build/ # Compiled output (generated)
│ ├── index.js # Compiled server
│ └── generated_tools.js # Compiled tools
├── package.json # Node.js dependencies
├── tsconfig.json # TypeScript config
├── swagger_get_only.json # TigerPaw API specification
├── generate_tools.cjs # Tool generator script
├── test_server.cjs # Server test script
├── generated_tools.json # Tool definitions (JSON)
├── TOOLS_SUMMARY.md # Complete tool documentation
├── README.md # This file
└── claude_desktop_config_example.json # Config template______________________________________________________________________
🔧 开发
构建
npm run build本地测试
# Windows
test_typescript_server.bat
# Or manually:
set TIGERPAW_PUBLIC_KEY=your-key
set TIGERPAW_PRIVATE_KEY=your-key
set TIGERPAW_BASE_URI=https://restapi.ideanetworks.com
node build/index.js再生工具
工具是根据TigerPaw的Swagger规范自动生成的。如果API有更新：
# Regenerate tools from swagger file
node generate_tools.cjs
# Rebuild
npm run build
# Test
node test_server.cjs
# Restart Claude Desktop to pick up changes注： 工具是自动生成的，源自于 swagger_get_only.json不要编辑 src/generated_tools.ts 手动地！
______________________________________________________________________
🔐 认证
使用TigerPaw的TSI认证方案：
- 签名：
{method}|{path}|{date}（全部小写） - HMAC-SHA256（哈希消息认证码-安全散列算法256位） 使用私钥
- 授权头：
TSI {base64(publicKey:signature)} - 日期格式： RFC 1123（例如，“Tue, 14 Oct 2025 20:33:59 GMT”）
______________________________________________________________________
📚 文档
- MCP 文档： https://modelcontextprotocol.io/docs（中文可表述为：模型上下文协议文档网站）
- MCP TypeScript SDK： https://github.com/modelcontextprotocol/typescript-sdk 翻译为中文是：“https://github.com/modelcontextprotocol/typescript-sdk（GitHub上的TypeScript SDK仓库）”。不过，通常在中文语境下，我们可能会简化为“GitHub上的ModelContextProtocol TypeScript SDK仓库”或直接保留原网址，因为网址本身在技术交流中是通用的。但如果要强调翻译的意图，可以如上所述进行表述
- TigerPaw API： 请联系TigerPaw获取API文档
______________________________________________________________________
❓ 故障排除
工具未在Claude中显示
- 验证配置文件位置：
%APPDATA%\Claude\claude_desktop_config.json - 检查路径是否正确（使用完整的绝对路径）
- 完全重启Claude桌面版 （在任务管理器中结束进程）
- 检查日志：
%APPDATA%\Claude\logs\mcp-server-tigerpaw.log
认证错误（401）
- 验证API密钥是否正确
- 检查
TIGERPAW_BASE_URI与您的TigerPaw实例匹配 - 确保您的计算机上的日期/时间设置正确（影响HMAC）
构建错误
# Clean rebuild
rmdir /s /q node_modules build
npm install
npm run build______________________________________________________________________
🐍 为什么选择 TypeScript 而不是 Python？
Python MCP SDK 已经 元组序列化错误 这导致了无法正常运行。TypeScript 是：
- ✅ 这个 参考实现 （最稳定）
- ✅ 没有序列化问题
- ✅ 由Anthropic提供更好的维护
- ✅ 更快的启动和执行速度
Python认证代码（tigerpaw_auth.py) 作为参考保留。
______________________________________________________________________
📝 许可证
\[此处填写您的许可证\]
______________________________________________________________________
🙏 致谢
- MCP协议： Anthropic（公司名，直译为“人类中心论者”，但在此上下文中通常保持原名不译，或根据具体语境译为“安萨提克”等音译名称，具体取决于品牌宣传策略）
- TigerPaw API： TigerPaw软件
- 认证实现： 基于TSI REST API文档
______________________________________________________________________
✅ 成功标准
当你看到以下情况时，就知道它起作用了：
- ✅ Claude 列出了 TigerPaw 工具
- ✅ 工具调用返回TigerPaw的实际数据
- ✅ 无认证错误
- ✅ 无序列化错误
______________________________________________________________________
有问题吗？ 检查 TYPESCRIPT_SETUP.md 请参阅详细的设置说明。