Itemit Mcp

🚀 itemit-mcp

itemit-mcp 是一个用于资产跟踪的 MCP 服务器，它在 itemit 资产管理 API 和模型上下文协议 (MCP) 生态系统之间架起了一座桥梁。

本项目由 uminai MCP 团队构建和维护。

📚 目录

• 概述
• 前提条件
• 获取 itemit API 凭证
• 安装与构建
• MCP 客户端配置
• 环境变量
• 可用的 MCP 工具
• 使用示例
• 响应格式
• 鸣谢与更多资源

📋 概述

itemit-mcp 通过 MCP 协议提供了一组与 itemit 资产管理平台进行交互的工具。它允许你以编程方式搜索、创建和管理资产及位置，从而轻松地将 itemit 与其他支持 MCP 的系统集成。以下是可用的工具：

• 获取物品列表
• 按名称搜索物品
• 创建物品
• 位置搜索（包含该位置上的物品列表）

⚙️ 前提条件

• Node.js（建议使用 v16+ 版本）
• 拥有 itemit 账户（用于获取 API 凭证）
• MCP 客户端（更多信息请参考 uminai MCP）

🔑 获取 itemit API 凭证

要使用此 MCP 服务器，你需要从 itemit 获取 API 凭证：

• ITEMIT_API_KEY
• ITEMIT_USER_ID
• ITEMIT_USER_TOKEN
• ITEMIT_WORKSPACE_ID

你可以通过在 itemit 上注册或登录，然后按照其 API 文档操作或联系他们的支持团队来获取这些凭证。

🛠️ 安装与构建

克隆此仓库并安装依赖项：

npm install

构建项目：

npm run build

⚙️ MCP 客户端配置

将以下内容添加到你的 MCP 客户端配置文件（例如 cline_mcp_settings.json）中：

{
"mcpServers": {
"itemit-mcp": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "node",
"args": [
"/Users//Documents/itemit-mcp/build/index.js"
],
"env": {
"ITEMIT_API_KEY": "",
"ITEMIT_USER_ID": "",
"ITEMIT_USER_TOKEN": "",
"ITEMIT_WORKSPACE_ID": ""
}
}
}
}

请将占位符值替换为你实际的 itemit 凭证。

🌐 环境变量

• ITEMIT_API_KEY：你的 itemit API 密钥
• ITEMIT_USER_ID：你的 itemit 用户 ID
• ITEMIT_USER_TOKEN：你的 itemit 用户令牌
• ITEMIT_WORKSPACE_ID：你的 itemit 工作区 ID

你可以在环境中或 .env 文件中设置这些变量。

🛠️ 可用的 MCP 工具

1. get-location-by-name

• 描述：在 itemit 中按名称获取位置。
• 参数：
  • name（字符串，必需）：要搜索的位置名称
  • limit（整数，可选）：要检索的位置数量（默认 25，最大 100）
  • skip（整数，可选）：要跳过的位置数量（默认 0）
• 示例：

  {
  "name": "Warehouse"
  }
  

2. search-item-by-name

• 描述：在 itemit 中按名称搜索物品。
• 参数：
  • name（字符串，必需）：要搜索的物品名称
  • size（整数，可选）：要检索的物品数量（默认 15，最大 100）
  • page（整数，可选）：页码（默认 1）
• 示例：

  {
  "name": "Laptop"
  }
  

3. create-item

• 描述：在 itemit 中创建一个物品。
• 参数：
  • name（字符串，必需）：物品名称
  • description（字符串，必需）：物品描述
  • serial（字符串，必需）：物品序列号
• 示例：

  {
  "name": "Projector",
  "description": "Epson HD Projector",
  "serial": "SN123456"
  }
  

4. get-reminders

• 描述：从 itemit 获取提醒信息。
• 参数：无

5. get-items

• 描述：从 itemit 获取物品。
• 参数：
  • size（整数，可选）：要检索的物品数量（默认 15，最大 100）
• 示例：

  {
  "size": 10
  }
  

💻 使用示例

使用你的 MCP 客户端调用这些工具。例如，要搜索一个物品：

{
"tool": "search-item-by-name",
"arguments": {
"name": "Laptop"
}
}

📄 响应格式

所有响应都以结构化文本或 JSON 形式返回，与 itemit API 的数据模型相匹配。例如，一次成功的搜索可能返回：

{
"content": [
{
"type": "text",
"text": "Search results for \"Laptop\" (size=15):\n1. Dell XPS 13 (ID: 1234)\n2. MacBook Pro (ID: 5678)\n..."
}
]
}

🙏 鸣谢与更多资源

• 本项目由 uminai MCP 团队开发。
• 由 itemit 提供支持。
• 更多 MCP 服务器和集成信息请访问 mcp.umin.ai。