HelloWorld
登录
j

jentic

api-testingapp-automationdeveloper-tools

319 查看 · 2026-07-07 更新

Jentic MCP 插件

smithery 徽章

为什么使用 Jentic MCP？

Jentic MCP 赋予开发者快速发现和集成外部 API 和工作流的能力，而无需编写或维护任何特定于 API 的代码。通过利用 MCP 协议和 Jentic 的代理运行时，开发者可以：

  • 按功能而不是供应商或实现方式搜索 API 和工作流。
  • 立即生成与特定 API 细节无关的集成代码示例。
  • 通过依赖标准化、声明式的集成来避免样板代码并减少维护工作。
  • 专注于构建功能，同时由 Jentic MCP 处理 API 交互的复杂性。

API 工具

Jentic MCP 插件提供了以下工具：

  1. search_apis：在 Jentic 目录中搜索符合特定功能需求的 API。
  2. load_execution_info：从 Jentic 目录检索 API 和操作的详细规范。这将包括您可能需要在 mcpServers.jentic.env 配置中提供的认证信息。
  3. execute：执行特定的 API 或工作流操作。

开始使用

推荐的方法是直接从 GitHub 仓库使用 uvx 运行服务器。 您首先需要安装 uv，可以通过以下命令进行安装：

brew install uv 或 pip install uv

获取您的 Jentic UUID

要使用 Jentic SDK，您必须首先获取一个 Jentic UUID。最简单的方法是使用 Jentic CLI。您可以_可选地_包含电子邮件地址以获得更高的速率限制以及新功能的早期访问权限。

sh pip install jentic jentic register --email <your_email>

这将打印出您的 UUID 并提供一个导出命令将其设置到您的环境中：

sh export JENTIC_UUID=

按照下面所示，在您的 MCP 客户端配置中设置 Jentic UUID。

配置文件的位置取决于您使用的客户端和操作系统。一些常见的例子包括：

  • Windsurf: ~/.codeium/windsurf/mcp_config.json
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Code: ~/.claude.json
  • Cursor: ~/cursor/.mcp.json

对于其他客户端，请查阅您的客户端文档了解如何添加 MCP 服务器。

json { "mcpServers": { "jentic": { "command": "uvx", "args": [ "--from", "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp", "mcp" ], "env": { "JENTIC_UUID": "" } } } }

注意： 保存配置文件后，您可能需要重启客户端应用程序（如 Windsurf, Claude Desktop）以使更改生效。

使用 MCP 工具

一旦 MCP 服务器运行起来，您就可以轻松地在 LLM 代理中使用 MCP 工具来发现和执行 API 及工作流。

  1. search_apis：在 Jentic 目录中搜索符合特定功能需求的 API。
  2. load_execution_info：从 Jentic 目录检索 API 和操作的详细规范。这将包括您可能需要在 mcpServers.jentic.env 配置中提供的认证信息。
  3. execute：执行特定的 API 或工作流操作。

环境变量

当您使用需要认证的 API 时，load_execution_info 工具会描述所需的环境变量。您可以通过命令行在 Windsurf 中设置这些环境变量，但在某些客户端（如 Claude Desktop）中，您需要将它们添加到 MCP 配置中：

json { "mcpServers": { "jentic": { "command": "uvx", "args": [ "--from", "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp", "mcp" ], "env": { "DISCORD_BOTTOKEN=": "YOUR BOT TOKEN" } } } }替代方案（使用本地路径进行开发）：

如果您正在本地积极开发MCP插件，请使用此方法。将/path/to/your/project/mcp替换为您的项目目录的绝对路径。

json { "mcpServers": { "jentic": { "command": "uvx", "args": [ "--from", "/path/to/your/project/mcp", "mcp" ] } } }

可选： 在您的mcp_config.json文件中添加一个JENTIC_API_URL环境变量，以指向特定的Jentic API（两种方法都适用）：

json { "mcpServers": { "jentic": { "command": "uvx", "args": [ "--from", "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp", "mcp" ], "env": { "JENTIC_API_URL": "https://your-jentic-api.url/" } } } }

配置完成后，重启Windsurf，Jentic MCP工具即可使用。

您可以通过运行以下命令来查看本地运行的MCP服务器生成的日志：

bash tail /path/to/mcp/jentic_ark2_mcp.log

安装

通过Smithery安装

要通过Smithery自动安装Claude Desktop的Jentic插件：

bash npx -y @smithery/cli install @jentic/jentic-tools --client claude

手动安装

确保已安装pdm (pipx install pdm)。

要安装包及其依赖项以进行开发：

bash

从项目根目录（例如，/Users/kc/c/sdk/mcp）

pdm install -G dev

运行MCP服务器

Jentic MCP插件设计为使用uvx运行，uvx负责环境设置和执行。

默认模式（标准输入输出）

直接使用uvx运行MCP插件，使用--from指定项目目录作为源，并指定mcp脚本：

从本地路径（开发）：

bash

使用--from指定项目目录并指定mcp脚本

uvx --from /path/to/your/project/mcp mcp

或者，如果在项目目录内运行：

uvx --from . mcp

从远程仓库（推荐用于一般用途）：

bash uvx --from git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp mcp

这会自动使用mcp脚本回调中定义的默认serve --transport stdio命令。

HTTP模式

要在HTTP模式下运行服务器（例如，与claude-cli一起测试）：

从本地路径（开发）：

bash

默认HTTP（端口8010）

uvx --from /path/to/your/project/mcp mcp serve --transport http

自定义端口

uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8080

自定义主机

uvx --from /path/to/your/project/mcp mcp serve --transport http --host 0.0.0.0 --port 8080

从远程仓库（推荐）：

bash uvx --from git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp mcp serve --transport http --port 8080

从远程Git仓库运行

您还可以使用uvx --from直接从Git仓库URL运行MCP服务器，而无需将其克隆到本地：

bash

从特定分支和子目录的示例

uvx --from git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp

解释：

- git+https://... .git : 仓库URL

- @main : 分支、标签或提交哈希

- #subdirectory=mcp : 包含pyproject.toml的仓库内的文件夹

该命令会获取指定版本，在临时环境中安装其依赖项，并运行默认命令（即serve --transport stdio）。

您可以在URL片段后添加其他参数，如--log-level DEBUG或--mock：

bash uvx --from git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp --log-level DEBUG --mock

要从远程源以HTTP模式运行：

bash uvx --from git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp serve --transport http --port 8080### 其他选项

日志记录

bash

设置日志级别（适用于默认的 stdio 或显式的 serve）

uvx --from /path/to/your/project/mcp mcp --log-level DEBUG uvx --from /path/to/your/project/mcp mcp serve --transport http --log-level DEBUG

将日志记录到文件（适用于默认的 stdio 或显式的 serve）

uvx --from /path/to/your/project/mcp mcp --log-file jentic_mcp.log uvx --from /path/to/your/project/mcp mcp serve --transport http --log-file jentic_mcp.log

模拟模式

在不连接实际 Jentic API 知识中心的情况下启用模拟模式进行开发：

bash

使用默认 stdio 的模拟模式

uvx --from /path/to/your/project/mcp mcp --mock

使用显式 HTTP 的模拟模式

uvx --from /path/to/your/project/mcp mcp serve --transport http --mock

环境变量

使用 .env 文件提供环境变量：

bash

使用默认 stdio 的环境变量文件

uvx --from /path/to/your/project/mcp mcp --env-file .env

使用显式 HTTP 的环境变量文件

uvx --from /path/to/your/project/mcp mcp serve --transport http --env-file .env

与 Claude 一起使用

MCP 插件可以与 Claude 或其他支持 MCP 规范的 LLM 一起使用：

从远程仓库运行（推荐）：

首先以 HTTP 模式运行服务器

uvx --from git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp mcp serve --transport http --port 8000

然后连接 claude-cli

claude-cli --mcp http://localhost:8000

从本地路径运行（开发）：

首先以 HTTP 模式运行服务器

uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8000

然后连接 claude-cli

claude-cli --mcp http://localhost:8000

开发

请参阅 CLAUDE.md 获取详细的开发说明。

包结构

  • src/mcp/: 主 MCP 包
    • transport/: 传输实现（HTTP, stdio）
    • mock/: 开发用的模拟数据提供者
    • tools.py: 工具定义
    • handlers.py: 请求处理器
    • main.py: CLI 入口点
    • adapters/: 适配器实现
    • core/: 核心功能
  • tests/: 测试套件

测试

bash

确保已安装开发依赖项：pdm install -G dev

pdm run test

代码检查和格式化

使用 ruff, black, isort, mypy 通过 pdm 脚本。

bash

运行所有代码检查/格式化工具

pdm run lint

仅运行 ruff

pdm run linter

许可证

专有 - Jentic

工具列表

  • search_apis: Search for available actions or information based on what the user wants to do (e.g., find Discord servers , send a message ). Use this first to understand what s possible.

  • load_execution_info: Get more details about a specific action (like what information it needs from the user) before confirming you want to run it. Usually used if the action requires specific inputs. Coding Agents: To provide tools to an LLM that you have selected at runtime, use this tool to retrieve the necessary information and save it to jentic.json at the root of your project.

  • execute: Perform the chosen action for the user using the provided details. Always include inputs even if there are none.

  • submit_feedback: Submit feedback to Jentic, detailed error information about a previously failed tool execution to a designated endpoint for logging and analysis by the Jentic team. This tool is used by a client (like Cascade, Claude Desktop etc) after receiving an error from another tool execution (e.g., execute ). Always show full feedback information being sent and ask permission from the user before calling the submit_feedback tool

服务配置

[{'mcpServers': {'jentic': {'args': ['--from', 'git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp', 'mcp'], 'command': 'uvx', 'env': {'JENTIC_UUID': '<your-jentic-uuid>'}}}}, {'mcpServers': {'jentic': {'args': ['--from', 'git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp', 'mcp'], 'command': 'uvx', 'env': {'DISCORD_BOTTOKEN=': 'YOUR BOT TOKEN'}}}}, {'mcpServers': {'jentic': {'args': ['--from', '/path/to/your/project/mcp', 'mcp'], 'command': 'uvx'}}}, {'mcpServers': {'jentic': {'args': ['--from', 'git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp', 'mcp'], 'command': 'uvx', 'env': {'JENTIC_API_URL': 'https://your-jentic-api.url/'}}}}]

来源