内容
# MCP Tekmetric
一款设计用于将 AI 助手与 Tekmetric 集成的模型上下文协议（MCP）服务器。该项目允许 AI 工具与您的 Tekmetric 数据交互，实现从 AI 助手直接进行自动化和智能工作流。
目前，此集成支持**只读操作**，允许您的 AI 从您的 Tekmetric 实例中检索信息。
## 示例用法
利用您的 AI 助手与您的 Tekmetric 数据交互：
- **📅 查看预约详情：** "明天预约的详情是什么？"
- **🚗 检索店铺信息：** "查找店铺的联系信息。"
- **📊 获取维修订单状态：** "维修订单 #12345 的当前状态是什么？"
---
## 🔐 身份验证设置
您需要 Tekmetric API 密钥才能与 Tekmetric API 进行身份验证。从您的 Tekmetric 账户设置中获取您的 API 密钥。
将您的 API 密钥设置为系统环境变量：
```bash
export TEKMETRIC_API_KEY="your_tekmetric_api_key"
```
---
## 🚀 快速入门指南
### 选项 1：本地运行（Python）
1. **克隆此仓库**:
```bash
git clone https://github.com/patclarke/mcp-tekmetric.git
cd mcp-tekmetric
```
2. **安装依赖项**:
```bash
pip install -e .
```
3. **启动服务器**:
```bash
uvicorn mcp_tekmetric.servers.main:asgi_app --host 0.0.0.0 --port 8080
```
---
### 选项 2：使用 Docker 运行
1. **克隆此仓库**:
```bash
git clone https://github.com/patclarke/mcp-tekmetric.git
cd mcp-tekmetric
```
2. **构建 Docker 镜像**:
```bash
docker build -t mcp-tekmetric .
```
3. **运行容器**（传递您的 Tekmetric API 密钥）：
```bash
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` 配置：
```json
{
"servers": {
"local-tekmetric": {
"type": "sse",
"url": "http://localhost:8080/sse"
}
}
}
```
---
## 🧪 健康检查
要验证服务器是否正在运行：
```bash
curl http://localhost:8080/healthz
```
您应该看到：
```json
{"status": "ok"}
```
---
## 📄 许可证
MIT 许可证
