Jentic MCP插件
为什么使用 Jentic MCP？
Jentic MCP 使开发人员能够快速发现和集成外部 API 和工作流，而无需编写或维护任何特定于 API 的代码。通过利用 MCP 协议和 Jentic 的 Agentic Runtime，开发人员可以：
- 按功能（而不是按供应商或实施）搜索 API 和工作流程。
- 立即生成与特定 API 细节无关的集成代码示例。
- 通过依赖标准化、声明式集成来避免样板并减少维护。
- 专注于构建功能，而 Jentic MCP 处理 API 交互的复杂性。
API 工具
Jentic MCP 插件提供以下工具：
search_apis ：在 Jentic 目录中搜索符合特定功能需求的 APIload_execution_info ：从 Jentic 目录中检索 API 和操作的详细规范。这将包含您可能需要在mcpServers.jentic.env配置中提供的身份验证信息。execute ：执行特定的 API 或工作流操作。
入门
推荐的方法是使用uvx直接从 GitHub 仓库运行服务器。您需要先使用以下命令安装uv ：
brew install uv或pip install uv
获取您的 Jentic UUID
要使用 Jentic SDK，您必须首先获取 Jentic UUID。最简单的方法是使用 Jentic CLI。您可以选择添加电子邮件地址，以获得更高的速率限制并提前体验新功能。
pip install jentic
jentic register --email '<your_email>'
这将打印您的 UUID 和一个导出命令以在您的环境中进行设置：
export JENTIC_UUID=<your-jentic-uuid>
在您的 MCP 客户端配置中设置 Jentic UUID，如下所示。
配置文件的位置取决于您使用的客户端和操作系统。以下是一些常见示例：
- 风帆冲浪：
~/.codeium/windsurf/mcp_config.json - Claude 桌面：
~/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-tools.git@main#subdirectory=mcp",
"mcp"
],
"env": {
"JENTIC_UUID": "<your-jentic-uuid>"
}
}
}
}
**注意：**保存配置文件后，您可能需要重新启动客户端应用程序（Windsurf、Claude Desktop）才能使更改生效。
MCP 工具使用
一旦 MCP 服务器运行，您就可以轻松使用 LLM 代理中的 MCP 工具来发现和执行 API 和工作流。
search_apis ：在 Jentic 目录中搜索符合特定功能需求的 APIload_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-tools.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"
]
}
}
}
*可选：*将JENTIC_API_URL环境变量添加到您的mcp_config.json文件以指向特定的 Jentic API（适用于两种方法）：
{
"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 服务器生成的日志：
tail /path/to/mcp/jentic_ark2_mcp.log
安装
确保已安装pdm （ pipx install pdm ）。
要安装开发包及其依赖项：
# From the project root directory (e.g., /Users/kc/c/sdk/mcp)
pdm install -G dev
运行 MCP 服务器
Jentic MCP 插件设计为使用uvx运行，它处理环境设置和执行。
默认模式（Stdio）
直接使用uvx运行 MCP 插件，使用--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-tools.git@main#subdirectory=mcp \
mcp
这会自动使用mcp脚本回调中定义的默认serve --transport stdio命令。
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-tools.git@main#subdirectory=mcp \
mcp serve --transport http --port 8080
从远程 Git 存储库运行
您还可以直接从 Git 存储库 URL 运行 MCP 服务器，而无需使用uvx --from在本地克隆它：
# Example from a specific branch and subdirectory
uvx --from \
git+https://github.com/jentic/jentic-tools.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 ）。
您可以在 URL 片段后添加其他参数，如--log-level DEBUG或--mock ：
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
--log-level DEBUG --mock
要从远程源以 HTTP 模式运行：
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
serve --transport 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
# 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
模拟模式
启用模拟模式进行开发，无需连接到实际的 Jentic API Knowledge Hub：
# 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
环境变量
使用.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
与 Claude 一起使用
MCP 插件可以与 Claude 或其他支持 MCP 规范的 LLM 一起使用：
从远程存储库运行（推荐）：
# Run the server in HTTP mode first
uvx --from \
git+https://github.com/jentic/jentic-tools.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 包transport/ ：传输实现（HTTP、stdio）mock/ ：用于开发的模拟数据提供者tools.py ：工具定义handlers.py ：请求处理程序main.py ：CLI入口点adapters/ ：适配器实现core/ ：核心功能
tests/ ：测试套件
测试
# Ensure dev dependencies are installed: pdm install -G dev
pdm run test
代码检查和格式化
通过 pdm 脚本使用ruff 、 black 、 isort 、 mypy 。
# Run all linters/formatters
pdm run lint
# Run only ruff
pdm run linter
执照
专有 - Jentic