Jentic MCP API集成插件

Jentic MCP（Model Context Protocol）插件是一个后端服务，它允许支持MCP协议的AI智能体（如Windsurf、Claude Desktop、Cursor等）以标准化的方式发现、理解和调用外部的API及工作流。通过此插件，智能体开发者无需编写和维护大量的API特定代码，即可快速集成外部能力。

主要功能点

API和工作流发现 (search_apis): 根据自然语言描述或关键词搜索Jentic知识库中可用的API和工作流能力。
获取执行信息 (load_execution_info): 获取所选API或工作流的详细执行信息，包括所需的输入参数、认证要求等，这些信息可用于生成智能体所需的工具定义和运行时配置。
执行工具 (execute): 执行指定的API操作或复杂工作流，处理输入参数并返回执行结果。

安装步骤

Jentic MCP插件是基于Python构建的，推荐使用'uvx'工具直接从GitHub仓库运行，这不需要传统的安装过程。

安装 'uv': 如果您的系统上没有安装'uv'，需要先安装它。
- 使用Homebrew (macOS):
```
brew install uv
```
- 使用pipx:
```
pipx install uv
```
- 使用pip (不推荐在基础Python环境中使用):
```
pip install uv
```

配置MCP客户端: Jentic MCP插件作为服务运行，需要由您的MCP客户端（如Windsurf, Claude Desktop, Cursor）启动和管理。您需要在客户端的配置文件中添加如下配置。配置文件的位置取决于您的客户端和操作系统（例如，Windsurf通常在 '~/.codeium/windsurf/mcp_config.json'）。

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                 // 在这里配置API认证所需的环璄变量，例如：
                 // "DISCORD_BOTTOKEN": "YOUR_DISCORD_BOT_TOKEN",
                 // "SPOTIFY_CLIENT_ID": "YOUR_SPOTIFY_CLIENT_ID",
                 // "SPOTIFY_CLIENT_SECRET": "YOUR_SPOTIFY_CLIENT_SECRET"
            }
        }
    }
}

'"jentic"': 这是您为该MCP服务器指定的名称，客户端会使用此名称来引用服务。
'"command"': 指定启动服务器的可执行命令，这里使用'uvx'。
'"args"': 指定传递给'uvx'命令的参数。'--from git+...' 参数告诉'uvx'从GitHub仓库的特定子目录运行'mcp'模块。
'"env"': (可选) 一个字典，用于设置运行服务器进程时所需的环境变量。特别是当您使用的API需要认证时，例如Discord或Spotify，您需要在'env'字段中提供API密钥或令牌等敏感信息。

重启客户端: 保存配置后，根据您的客户端要求，可能需要重启应用程序以使配置生效。

基本使用方法

一旦配置完成且客户端成功启动了Jentic MCP服务器，您的AI智能体或客户端即可通过MCP协议调用其暴露的工具。典型的交互流程包括：

智能体接收用户请求（例如：“在Discord上发送一条消息”）。
智能体识别需要外部工具，调用Jentic MCP的 'search_apis' 工具，提供用户需求的描述。
'search_apis' 返回匹配的API或工作流列表（例如，Discord的 'postChannelMessage' 工作流）。
智能体向用户展示匹配结果并确认。
（如果需要输入参数或生成代码）智能体调用 'load_execution_info' 工具，提供选定工作流的UUID，获取其详细输入要求和配置信息。这些信息可以帮助智能体理解如何构造调用参数。
智能体收集所需的参数（例如，从用户处获取Discord频道ID和消息内容）。
智能体调用 'execute' 工具，指定要执行的工作流UUID和收集到的输入参数。
'execute' 工具在后端执行实际的API调用或工作流。
'execute' 返回执行结果，智能体将结果呈现给用户。

通过这种方式，智能体无需了解底层API的具体实现细节，只需与Jentic MCP插件进行标准化的工具交互即可。

关键词

Jentic MCP API集成插件

主要功能点

安装步骤

基本使用方法

信息