MCP Tekmetric

这是一个设计用于将AI助手与Tekmetric集成的模型上下文协议（MCP）服务器。该项目允许AI工具与您的Tekmetric数据进行交互，使您能够直接从AI助手实现自动化和智能工作流程。

当前，此集成支持只读操作，允许您的AI从您的Tekmetric实例中检索信息。

示例用法

利用您的AI助手与您的Tekmetric数据进行交互：

• 📅 查看预约详情："明天的预约详情是什么？"
• 🚗 获取店铺信息："查找某个店铺的联系方式。"
• 📊 获取维修订单状态："维修订单#12345的当前状态是什么？"

---

🔐 认证设置

您需要一个Tekmetric API密钥来与Tekmetric API进行认证。从您的Tekmetric账户设置中获取API密钥。

将您的API密钥设置为系统环境变量：

export TEKMETRIC_API_KEY="your_tekmetric_api_key"

---

🚀 快速入门指南

方案1：本地运行（Python）

1. 克隆此仓库：

   git clone https://github.com/patclarke/mcp-tekmetric.git
   cd mcp-tekmetric
   

2. 安装依赖项：

   pip install -e .
   

3. 启动服务器：

   uvicorn mcp_tekmetric.servers.main:asgi_app --host 0.0.0.0 --port 8080
   

---

方案2：使用Docker运行

1. 克隆此仓库：

   git clone https://github.com/patclarke/mcp-tekmetric.git
   cd mcp-tekmetric
   

2. 构建Docker镜像：

   docker build -t mcp-tekmetric .
   

3. 运行容器（传递您的Tekmetric API密钥）：

   docker run -e TEKMETRIC_API_KEY=your_tekmetric_api_key -p 8080:8080 mcp-tekmetric
   

这将在http://localhost:8080上公开服务器。

---

🤖 连接您的AI助手

对于VS Code Copilot或其他支持MCP的AI助手：

示例.mcp.json配置：

{
  "servers": {
    "local-tekmetric": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

---

🧪 健康检查

验证服务器是否正在运行：

curl http://localhost:8080/healthz

您应该看到：

{"status": "ok"}

---

📄 许可证

MIT许可证