Name: API集成插件
Author: jentic

使用说明

Jentic MCP插件

为什么使用Jentic MCP？

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

按功能搜索API和工作流，而不是按供应商或实现。
即时生成与特定API详细信息无关的集成代码示例。
通过依赖标准化的声明性集成，避免样板文件并减少维护。
专注于构建功能，而JenticMCP处理API交互的复杂性。

API工具

Jentic MCP插件提供以下工具：

search_apis：在Jentic目录中搜索与特定功能需求匹配的API
load_execution_info：从Jentic目录中检索API和操作的详细规范。 这将包括您可能需要在您的 mcpServers.jentic.env 配置。
execute：执行特定的API或工作流操作。

入门指南

建议的方法是使用以下命令直接从GitHub存储库运行服务器 uvx. 您需要安装 uv 首次使用：

brew install uv 或 pip install uv

代理API密钥

在以下位置创建代理https://app.jentic.com/sign-in并复制其API密钥。

export JENTIC_AGENT_API_KEY=<your-agent-api-key>

在MCP客户端配置中设置密钥，如下所示。

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

帆板运动: ~/.codeium/windsurf/mcp_config.json
克劳德桌面版: ~/Library/Application Support/Claude/claude_desktop_config.json
克劳德代码: ~/.claude.json
光标: ~/cursor/.mcp.json

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

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "JENTIC_AGENT_API_KEY": "<your-agent-api-key>"
            }
        }
    }
}

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

MCP工具使用

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

search_apis：在Jentic目录中搜索与特定功能需求匹配的API
load_execution_info：从Jentic目录中检索API和操作的详细规范。 这将包括您可能需要在您的 mcpServers.jentic.env 配置。
execute：执行特定的API或工作流操作。

环境变量

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

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "DISCORD_BOTTOKEN=": "YOUR BOT TOKEN"
            }
        }
    }
}

备选方案（利用当地发展道路）：

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

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

可选： 添加a JENTIC_API_URL 环境变量到您的 mcp_config.json 文件指向特定的Jentic API（与这两种方法一起使用）：

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

配置后，重新启动Windsurf，Jentic MCP工具将可用。

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

tail /path/to/mcp/jentic_ark2_mcp.log

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的Jentic插件铁匠铺:

npx -y @smithery/cli install @jentic/jentic-sdks --client claude

手动安装

确保你有 pdm 已安装(pipx install pdm).

要安装软件包及其开发依赖项，请执行以下操作：

# From the project root directory (e.g., /Users/kc/c/sdk/mcp)
pdm install -G dev

运行MCP服务器

Jentic MCP插件设计为使用 uvx，它处理环境设置和执行。

默认模式（标准）

直接使用以下命令运行MCP插件 uvx，指定项目目录 作为来源 使用 --from 和那个 mcp 脚本：

来自本地路径（发展）：

# Use --from with the project directory and specify the 'mcp' script
uvx --from /path/to/your/project/mcp mcp

# Or, if running from within the project directory:
uvx --from . mcp

来自远程存储库（建议一般使用）：

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

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

HTTP模式

MCP服务器支持两种HTTP传输模式：

标准HTTP：传统的请求-响应HTTP模式
可流式传输的HTTP：支持流媒体的HTTP模式，与MCP Inspector兼容

标准HTTP模式

在标准HTTP模式下运行服务器（例如，用于测试 claude-cli):

来自本地路径（发展）：

# Default HTTP (port 8010)
uvx --from /path/to/your/project/mcp mcp serve --transport http

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

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

来自远程存储库（推荐）：

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

流式HTTP模式

要在流式HTTP模式下运行服务器（与MCP Inspector兼容）：

来自本地路径（发展）：

# Default streamable HTTP (port 8010)
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-http

# With custom port
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-http --port 8080

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

来自远程存储库（推荐）：

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

从远程Git仓库运行

您还可以直接从Git存储库URL运行MCP服务器，而无需使用以下命令在本地克隆它 uvx --from:

# Example from a specific branch and subdirectory
uvx --from \
  git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp

# Explanation:
# - git+https://... .git : The repository URL
# - @main   : The branch, tag, or commit hash
# - #subdirectory=mcp     : The folder within the repo containing the pyproject.toml

此命令获取指定版本，在临时环境中安装其依赖项，并运行默认命令（ serve --transport stdio).

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

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

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

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

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

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

其他选项

日志记录

# Set logging level (applies to default stdio or explicit 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
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-http --log-level DEBUG

# Log to file (applies to default stdio or explicit 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
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-http --log-file jentic_mcp.log

模拟模式

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

# Mock mode with default stdio
uvx --from /path/to/your/project/mcp mcp --mock

# Mock mode with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --mock

# Mock mode with streamable HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-http --mock

环境变量

使用 .env 文件：

# Env file with default stdio
uvx --from /path/to/your/project/mcp mcp --env-file .env

# Env file with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --env-file .env

# Env file with streamable HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-http --env-file .env

与克劳德一起使用

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

从远程存储库运行（推荐）：

# Run the server in HTTP mode first
uvx --from \
  git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp \
  mcp serve --transport http --port 8000

# Then connect claude-cli
claude-cli --mcp http://localhost:8000

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

# Run the server in HTTP mode first
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8000

# Then connect claude-cli
claude-cli --mcp http://localhost:8000

发展

看 CLAUDE.md 详细的开发说明。

封装结构

src/mcp/：主MCP包
- mock/：用于开发的模拟数据提供者
- tools.py：工具定义
- handlers.py：请求处理程序
- main.py：CLI入口点
- adapters/：适配器实现
- core/：核心功能
tests/：测试套件

测试

# Ensure dev dependencies are installed: pdm install -G dev
pdm run test

装订和格式化

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

# Run all linters/formatters
pdm run lint

# Run only ruff
pdm run linter

使用说明

Jentic MCP插件

为什么使用Jentic MCP？

API工具

入门指南

代理API密钥

MCP工具使用

环境变量

安装

通过Smithery安装

手动安装

运行MCP服务器

默认模式（标准）

HTTP模式

标准HTTP模式

流式HTTP模式

从远程Git仓库运行

其他选项

日志记录

模拟模式

环境变量

与克劳德一起使用

发展

封装结构

测试

装订和格式化

相关 MCP

实时网络搜索服务

图像生成服务

滴滴出行MCP服务

开发者辅助工具

Unity MCP AI游戏开发工具

MongoDB 数据库 MCP 服务器