自动化登录服务器

一个提供自动化登录功能的MCP服务器,适用于浏览器自动化工具如Playwright MCP服务器。

  • by nieperdragon
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 nieperdragon/custom_mcp

使用说明

MCP登录服务器

一种模型上下文协议(MCP)服务器,为以下对象提供自动登录功能 http://localhost 使用预定义的凭据。此服务器旨在与Playwright MCP服务器等浏览器自动化工具配合使用。

特性

  • 自动登录:提供使用预定义凭据执行登录操作的工具
  • 剧作家整合:设计用于与Playwright MCP服务器配合使用,实现浏览器自动化
  • 连接测试:包括测试与目标URL连接的工具
  • 凭据管理:安全处理登录凭据
  • 可扩展架构:易于添加具有单独工具定义的新工具

项目结构

src/
├── index.ts          # Main server setup and entry point
├── tools.ts          # Tool definitions and registration
└── index.js          # Compiled JavaScript (auto-generated)

代码库的结构便于扩展:

  • index.ts:包含主服务器设置、启动逻辑和进程管理
  • tools.ts:包含所有工具定义、注册函数和配置
  • ADDING_TOOLS.md:向服务器添加新工具的详细指南

安装

npm install
npm run build

用法

运行服务器

npm start

或用于开发:

npm run dev

可用工具

服务器提供以下MCP工具:

  1. 性能登录 -执行自动登录http://localhost使用预定义的凭据
  2. get_login_credentials -返回用于验证的登录凭据
  3. test_连接 -测试目标URL是否可访问

配置

服务器配置了以下凭据:

  • 目标网址: http://localhost
  • 用户名: admin
  • 密码: AIWorkshopJuly!25

这些凭据是为在本地主机上运行的OrangeHRM系统配置的。

MCP配置

要将此服务器与MCP客户端(如Claude for Desktop)一起使用,请添加以下配置:

视窗

{
  "mcpServers": {
    "login-server": {
      "command": "node",
      "args": ["C:\\ABSOLUTE\\PATH\\TO\\PROJECT\\build\\index.js"]
    }
  }
}

macOS/Linux

{
  "mcpServers": {
    "login-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PROJECT/build/index.js"]
    }
  }
}

与Playwright MCP服务器集成

该服务器旨在与Playwright MCP服务器协同工作,实现完全的浏览器自动化。这 perform_login 该工具提供了Playwright MCP服务器可以执行的必要信息和步骤。

工作流示例

  1. 使用 test_connection 用于验证目标URL是否可访问的工具
  2. 使用 perform_login 获取登录说明的工具
  3. 使用Playwright MCP服务器工具执行浏览器自动化步骤

发展

项目结构

src/
├── index.ts          # Main server implementation
├── types.ts          # TypeScript type definitions (if any)
build/                # Compiled JavaScript output
.github/              # GitHub configuration
├── copilot-instructions.md  # Copilot development guidelines

建筑

npm run build

脚本

  • npm run build -将TypeScript编译为JavaScript
  • npm start -运行已编译的服务器
  • npm run dev -构建并运行开发模式
  • npm run clean -清理构建目录

依赖项

  • @modelcontextprotocol/sdk -用于TypeScript的MCP SDK
  • zod -运行时类型验证
  • typescript -TypeScript编译器

错误处理

该服务器包括全面的错误处理功能,用于:

  • 连接失败
  • 无效凭证
  • 网络超时
  • MCP协议错误

安全

  • 凭据作为常量存储在代码中
  • 没有敏感数据记录到stdout(仅记录到stderr进行调试)
  • 连接测试使用安全的HTTP HEAD请求

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 彻底测试
  5. 提交拉取请求

许可证

ISC许可证