Boilerplate MCP Server

Boilerplate MCP Server

site icon
2025.03.19 0
TypeScriptIP查询服务位置服务
personal-mcp-server 是一个基于 TypeScript 实现的 Model Context Protocol (MCP) 服务器模板项目。它为 AI 应用(如 Claude Desktop)提供工具和资源,可作为开发 MCP 兼容服务器的起点。该项目注重清晰的架构、自动化工作流程和便捷的部署。
View on GitHub

Overview

基本能力

产品定位

personal-mcp-server 是一个 MCP 服务器模板,旨在为 AI 应用提供工具和资源支持。

核心功能

  • STDIO MCP 服务器:为 AI 客户端(如 Claude Desktop)提供工具和资源
  • CLI 支持:提供用户友好的命令行界面,便于直接测试和使用
  • IP 地址查询:获取任何 IP 地址或当前设备 IP 的详细信息
  • 自动化发布管理:通过 GitHub Actions 工作流实现持续集成、测试和发布到 GitHub Packages

适用场景

  • 为 AI 应用(如 Claude Desktop 或 Cursor AI)提供 IP 查询服务
  • 作为开发 MCP 兼容服务器的起点
  • 需要快速部署 IP 查询功能的场景

工具列表

  • get-ip-details:获取 IP 地址的详细信息,包括国家、地区、城市、ISP 等

常见问题解答

无明确常见问题解答部分

使用教程

使用依赖

需要安装 Node.js 和 npm

安装教程

全局安装

npm install -g @aashari/boilerplate-mcp-server

本地安装

git clone https://github.com/aashari/boilerplate-mcp-server.git
cd boilerplate-mcp-server
npm install

运行命令

  • 开发模式:
npm run dev
  • 构建并启动:
npm run build
npm start

调试方式

  • 获取帮助:
boilerplate-mcp-server --help
  • 获取当前 IP 详情:
boilerplate-mcp-server get-ip-details
  • 获取特定 IP 详情:
boilerplate-mcp-server get-ip-details 8.8.8.8

许可证

该项目遵循 ISC 开源许可条款。