AI导哈

TigerPaw API访问服务

一个为Claude Desktop提供TigerPaw API端点访问的模型上下文协议（MCP）服务器，支持通过自然语言对话查询账户、联系人、服务订单等269个API端点。

  • by haydenbarker-idea
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 haydenbarker-idea/tigerpaw_MCP

使用说明

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）

安装

  1. 克隆并安装：

    git clone <your-repo-url>
cd tigerpaw_MCP
npm install

  2. 构建：

    npm run build

  3. 配置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"
      }
    }
  }
}

  4. 重启Claude桌面版 完全地

  5. 测试： 问克劳德：“你有哪些可用的工具？”

🛠️ 可用工具

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认证方案：

  1. 签名： {method}|{path}|{date} （全部小写）
  2. HMAC-SHA256（哈希消息认证码-安全散列算法256位） 使用私钥
  3. 授权头： TSI {base64(publicKey:signature)}
  4. 日期格式： 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中显示

  1. 验证配置文件位置： %APPDATA%\Claude\claude_desktop_config.json
  2. 检查路径是否正确（使用完整的绝对路径）
  3. 完全重启Claude桌面版 （在任务管理器中结束进程）
  4. 检查日志： %APPDATA%\Claude\logs\mcp-server-tigerpaw.log

认证错误（401）

  1. 验证API密钥是否正确
  2. 检查 TIGERPAW_BASE_URI 与您的TigerPaw实例匹配
  3. 确保您的计算机上的日期/时间设置正确（影响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文档

✅ 成功标准

当你看到以下情况时，就知道它起作用了：

  1. ✅ Claude 列出了 TigerPaw 工具
  2. ✅ 工具调用返回TigerPaw的实际数据
  3. ✅ 无认证错误
  4. ✅ 无序列化错误

有问题吗？ 检查 TYPESCRIPT_SETUP.md 请参阅详细的设置说明。

相关 MCP