AI导哈

API桥接工具

NetADX AI-CORE MCP Stdio Wrapper是一个用于在Claude Desktop和NetADX AI-CORE API服务器之间进行通信的桥接工具，通过stdio MCP协议实现无缝连接。

  • by netadx1ai
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 netadx1ai/mcp-stdio-wrapper

使用说明

NetADX AI-CORE MCP标准包装机

使Claude Desktop能够通过stdio MCP协议连接到NetADX AI-CORE API服务器。

概述

此包提供了一个stdio包装器，可以在以下内容之间进行转换：

  • stdio MCP协议（由Claude Desktop、Cline和其他MCP客户端使用）
  • 基于HTTPNetADX AI-CORE API服务器（REST API）

这使Claude Desktop能够无缝使用NetADX AI-CORE API服务器提供的所有工具。

快速开始

1.获取JWT Token

向NetADX AI-CORE管理员请求JWT令牌，或生成一个用于开发：

# Example: Generate token for user
node -e "
const jwt = require('jsonwebtoken');
const token = jwt.sign(
  { userObjId: 'YOUR_USER_ID' },
  'netadxAPI',
  { algorithm: 'HS256', expiresIn: '24h' }
);
console.log(token);
"

2.配置克劳德桌面

添加到您的 claude_desktop_config.json:

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "netadx-api": {
      "command": "npx",
      "args": ["-y", "@netadx1ai/mcp-stdio-wrapper@latest"],
      "env": {
        "API_URL": "https://api.netadx.ai",
        "JWT_TOKEN": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "LOG_FILE": "/tmp/netadx-mcp.log"
      }
    }
  }
}

3.重新启动克劳德桌面

重新启动Claude Desktop以加载MCP服务器。

4.验证连接

在Claude Desktop中，问：

Can you list the available NetADX tools?

Claude应通过NetADX AI-CORE API服务器提供的可用工具列表进行回复。

配置

环境变量

变量 必填 描述 示例
API_URL 否 NetADX AI-CORE API基础URL https://api.netadx.ai
JWT_TOKEN 是 您的JWT身份验证令牌 eyJhbGci...
LOG_FILE 无 调试日志文件的路径 /tmp/netadx-mcp.log

开发设置

对于本地开发或测试：

{
  "mcpServers": {
    "netadx-api-dev": {
      "command": "npx",
      "args": ["-y", "@netadx1ai/mcp-stdio-wrapper@latest"],
      "env": {
        "API_URL": "http://localhost:8025",
        "JWT_TOKEN": "your-dev-token",
        "LOG_FILE": "/tmp/netadx-mcp-dev.log"
      }
    }
  }
}

可用工具

配置后，Claude Desktop可以使用NetADX AI-CORE API服务器提供的所有工具。可用的工具取决于您的服务器配置和实现。

例如，NetADX AI-CORE样板包括：

工具 说明
example_tool 学习和测试的CRUD操作示例

根据您的业务需求，您的生产服务器可能包含其他自定义工具。

Claude Desktop中的示例用法

列出项目（使用example_tool）

Claude, can you list all items using the example tool?

克劳德将执行 example_tool:

{
  "action": "list_items"
}

创建项目

Claude, please create a new item with name "Test Item" and value 123

克劳德将执行 example_tool:

{
  "action": "create_item",
  "data": {
    "name": "Test Item",
    "value": 123
  }
}

获取特定项目

Claude, get the item with ID abc123

克劳德将执行 example_tool:

{
  "action": "get_data",
  "id": "abc123"
}

故障排除

1.“JWT_TOKEN环境变量是必需的”

问题： 未提供JWT令牌

解决方案： 添加 JWT_TOKEN 到您的Claude Desktop配置：

"env": {
  "JWT_TOKEN": "your-jwt-token-here"
}

2.“身份验证失败：JWT令牌无效或过期”

问题： 令牌无效或已过期

解决方案： 生成一个具有正确秘密和所需声明的新令牌：

const token = jwt.sign(
  { userObjId: 'YOUR_USER_ID' },  // Required claim
  'your-jwt-secret',              // Must match server JWT_SECRET
  { algorithm: 'HS256', expiresIn: '24h' }
);

3.工具未出现在Claude Desktop中

问题： MCP服务器未加载

解决方案：

  1. 检查 claude_desktop_config.json 是有效的JSON
  2. 重新启动克劳德桌面
  3. 检查日志文件，如果 LOG_FILE 已设置
  4. 验证npx是否可以下载该包

4.检查日志

如果你设置 LOG_FILE，检查日志：

tail -f /tmp/netadx-mcp.log

日志输出示例：

[2025-10-31T08:36:19.128Z] NetAdxApiClient initialized {"baseUrl":"https://api.netadx.ai"}
[2025-10-31T08:36:20.456Z] Fetching tools from NetADX AI-CORE API
[2025-10-31T08:36:21.123Z] Tools fetched successfully {"count":1}
[2025-10-31T08:36:25.789Z] Executing tool {"name":"example_tool","args":{"action":"list_items"}}
[2025-10-31T08:36:26.234Z] Tool executed successfully {"name":"example_tool","success":true}

本地开发

再进行

cd mcp-stdio-wrapper
npm install

以开发模式运行

# Set environment variables
export API_URL="https://api.netadx.ai"
export JWT_TOKEN="your-jwt-token"
export LOG_FILE="/tmp/netadx-mcp-dev.log"

# Run with tsx
npm run dev

构建

npm run build

使用Claude Desktop进行本地测试

而非 npx，使用本地路径：

{
  "mcpServers": {
    "netadx-api-local": {
      "command": "node",
      "args": ["/path/to/mcp-stdio-wrapper/dist/index.js"],
      "env": {
        "API_URL": "http://localhost:8025",
        "JWT_TOKEN": "your-dev-token",
        "LOG_FILE": "/tmp/netadx-mcp-local.log"
      }
    }
  }
}

发布到npm

# Login to npm
npm login

# Publish (requires @netadx1ai organization access)
npm publish --access public

建筑

┌─────────────────┐
│ Claude Desktop  │
│   (stdio MCP)   │
└────────┬────────┘
         │ stdio protocol
         │ (JSON-RPC 2.0)
         ▼
┌─────────────────┐
│  This Wrapper   │
│  stdio → HTTP   │
└────────┬────────┘
         │ HTTP/REST
         │ (x-access-token)
         ▼
┌─────────────────┐
│  NetADX AI-CORE API v5    │
│ (HTTP MCP)      │
└─────────────────┘

安全注意事项

  • 永远不要将JWT令牌提交给版本控制
  • 令牌在配置的持续时间（通常为1-24小时）后过期-根据需要生成新的令牌
  • 将令牌安全地存储在环境变量或凭据管理器中
  • 在生产环境中使用HTTPS

支持

许可证

MIT许可证-有关详细信息，请参阅许可证文件

更新日志

版本2.1.3 （当前）

  • 专业B2B文档
  • NetADX AI-CORE品牌
  • 简化配置示例

版本2.1.1

  • 更新了环境变量名称
  • 改进了错误处理

版本2.1.0

  • 支持Claude Desktop的初始版本
  • HTTP到stdio协议转换
  • JWT身份验证支持

维护单位： NetADX团队
联系人： hello@netadx.ai
网站： https://netadx.ai
最后更新: 2025-01-09

相关 MCP