Azsap MCP Typescript

Azure MCP服务器上的SAP（TypeScript实现）

Azure上SAP的模型上下文协议（MCP）服务器的TypeScript实现，为SAP HANA数据库管理和Azure资源管理提供工具。

特性

• 多种运输方式：支持STDIO、HTTP和SSE传输
• SAP HANA 集成：用于查询和管理SAP HANA数据库的工具
• Azure虚拟机管理：用于管理Azure虚拟机的工具（启动、停止、状态）
• Azure NSG 运营：网络安全组管理工具
• 资源监控：用于跟踪系统资源的工具
• TypeScript实现：具有现代ECMAScript特性的全类型实现

安装

# Clone the repository
git clone 
cd azsap-mcp-typescript

# Install dependencies
npm install

# Configure your environment
cp .env.example .env
# Edit .env with your SAP HANA and Azure credentials

# Build the project
npm run build

运行服务器

STDIO传输（适用于克劳德桌面）

npm start

HTTP传输（用于web客户端）

npm run start:http

或者使用自定义主机/端口：

node dist/server-cli.js --transport http --host localhost --port 3000

使用客户端

该包包括一个可以连接到MCP服务器的客户端实现：

# Connect to a local STDIO server
npm run client -- --transport stdio --command "node" --args "dist/server-cli.js"

# Connect to an HTTP server
npm run client -- --transport http --host localhost --port 3000

# Execute a specific tool
npm run client -- --transport http --host localhost --port 3000 --tool get_system_overview

用作图书馆

您还可以在自己的项目中将此包用作库：

import { createServer, connectServer, AzureMCPClient } from 'azsap-mcp-typescript';

// Create and start a server
const server = createServer();
await connectServer(server, 'stdio');

// Or use the client
const client = new AzureMCPClient({
  transport: 'http',
  host: 'localhost',
  port: 3000
});

await client.connect();
const status = await client.getVmStatus('SID001', 'db', 'myResourceGroup');
console.log(status);

Docker支持

容器化部署包含一个Dockerfile：

# Build the Docker image
docker build -t azsap-mcp-typescript .

# Run with environment variables
docker run -p 3000:3000 \
  -e HANA_HOST=your-hana-host \
  -e HANA_PORT=30215 \
  -e HANA_USER=your-user \
  -e HANA_PASSWORD=your-password \
  -e HANA_SCHEMA=your-schema \
  azsap-mcp-typescript

Claude桌面集成

要与Claude Desktop集成，请配置 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "sap-hana-ts": {
      "command": "node",
      "args": ["/path/to/azsap-mcp-typescript/dist/server-cli.js"],
      "env": {
        "HANA_HOST": "your-hana-host",
        "HANA_PORT": "30215",
        "HANA_USER": "your-user",
        "HANA_PASSWORD": "your-password"
      }
    }
  }
}

项目结构

该项目遵循标准的Node.js/TypeScript包结构：

├── src/                  # Source code
│   ├── index.ts          # Main entry point and library exports
│   ├── server-cli.ts     # CLI for running the server
│   ├── client-cli.ts     # CLI for running the client
│   ├── client.ts         # MCP client implementation
│   ├── hana-connection.ts # SAP HANA connection utilities
│   ├── tools/            # Tool implementations
│   │   ├── system-overview.ts
│   │   ├── disk-usage.ts
│   │   └── azure-tools/   # Azure-specific tools
│   │       └── vm-operations.ts
│   └── utils/            # Utility functions
│       ├── format.ts     # Formatting utilities
│       ├── logger.ts     # Logging configuration
│       └── types.ts      # TypeScript type definitions
├── test/                 # Test files
├── dist/                 # Compiled output (generated)
└── logs/                 # Log files (generated)

可用工具

服务器目前提供以下工具：

SAP HANA 工具

• get_system_overview：获取系统状态、主机信息、服务状态和内存使用情况
• get_disk_usage：检查卷、数据文件和日志文件的磁盘空间使用情况

Azure虚拟机工具

• get_vm_status：获取Azure VM的当前状态
• start_vm：启动Azure虚拟机
• stop_vm：停止Azure VM（使用可选的取消分配）
• restart_vm：重新启动Azure虚拟机
• list_vms：列出资源组或订阅中的所有虚拟机

文档

有关可用工具及其参数的更多信息，请参阅源代码和JSDoc注释。

测试

# Run all tests
npm test

# Run specific tests
npm test -- -t "system overview"

许可证

麻省理工学院