AI导哈

MCP服务器初始化器

一个VS Code扩展，用于创建具有即用型Python代码的MCP（模型上下文协议）服务器文件夹结构。

  • by jasonshen190
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jasonshen190/mcp-server-initiator

使用说明

MCP服务器启动器

一个VS Code扩展，使用现代FastMCP框架创建MCP（模型上下文协议）服务器文件夹结构，其中包含现成的Python代码。

最新版本：0.0.9

示例项目： 查看此扩展生成的真实示例： 我的mcp服务器 --此存储库演示了使用此扩展时将获得的结构和功能。

特性

  • 使用FastMCP创建完整的MCP服务器文件夹结构
  • 生成具有HTTP传输的现成Python代码
  • 同时支持VS代码和游标
  • 交互式文件夹命名与验证
  • 创建后自动打开文件夹
  • 包括全面的工具、资源和提示功能
  • 内置测试客户端，用于即时测试
  • 设置脚本，便于依赖关系管理

用法

  1. 打开VS代码或光标
  2. 打开要在其中创建MCP服务器的工作区文件夹
  3. 打开命令选项板(Cmd+Shift+P 在macOS上， Ctrl+Shift+P 在Windows/Linux上）
  4. 键入“创建MCP服务器”并选择命令
  5. 出现提示时输入文件夹名称
  6. 扩展程序将创建完整的文件夹结构并将其打开

运行生成的MCP服务器

生成服务器后，您有几个选项可以运行它：

选项1：使用安装脚本（推荐）

cd <your-folder-name>/src
python setup_and_run.py

选项2：直接服务器运行

cd <your-folder-name>/src
python demo_server.py

选项3：测试服务器

cd <your-folder-name>/src
python test_client.py

生成的结构

<folder-name>/
├── src/
│   ├── components/
│   │   ├── __init__.py      # Components package initialization
│   │   ├── tools.py         # Tool functions and models
│   │   ├── resources.py     # Resource functions
│   │   └── prompts.py       # Prompt functions
│   ├── demo_server.py       # Main MCP server implementation
│   ├── setup_and_run.py     # Setup and run script
│   ├── test_client.py       # Test client for the server
│   ├── mcp.json            # MCP server configuration
│   └── README.md           # Server documentation
└── requirements.txt        # Python dependencies

安装

为了发展

  1. 克隆此存储库
  2. 导航到扩展目录：
    cd mcp-server-initiator
  3. 安装依赖项：
    npm install
  4. 编译扩展：
    npm run compile
  5. 在VS Code中打开扩展：
    code .
  6. 按 F5 在新的“扩展开发主机”窗口中运行扩展

用于生产

  1. 打包扩展：

    npm run package

  2. 安装生成的 .vsix VS代码或游标中的文件：

    方法1：使用扩展面板

    • 打开VS代码/光标
    • 转到扩展(Cmd+Shift+X 在macOS上， Ctrl+Shift+X 在Windows/Linux上）
    • 寻找以下选项之一：
      • 单击扩展面板标题中的“…”（更多操作）菜单
      • 点击齿轮图标(⚙️) 在“扩展”面板中
      • 在“扩展”面板区域中单击鼠标右键
    • 选择“从VSIX安装…”
    • 选择生成的 .vsix 项目目录中的文件
    • 点击“安装”
    • 出现提示时重新加载编辑器

    方法2：拖放

    • 打开VS代码/光标
    • 转到扩展(Cmd+Shift+X 在macOS上， Ctrl+Shift+X 在Windows/Linux上）
    • 只需拖动 .vsix 从文件资源管理器中删除文件，并将其放入“扩展”面板
    • 出现提示时单击“安装”
    • 出现提示时重新加载编辑器

    方法3：命令行（推荐）

    # For VS Code
code --install-extension mcp-server-initiator-0.0.1.vsix

# For Cursor
cursor --install-extension mcp-server-initiator-0.0.1.vsix

    方法4：文件菜单

    • 打开VS代码/光标
    • 转到文件→ 从VSIX安装。..
    • 选择生成的 .vsix 文件
    • 点击“安装”
    • 出现提示时重新加载编辑器

  3. 测试生成的服务器

    cd <your-folder-name>/src
python setup_and_run.py

生成的代码特性

主服务器(src/demo_server.py)

  • 使用FastMCP框架完成MCP服务器的实现
  • HTTP传输支持，便于测试和开发
  • 综合工具包括：
    • 数学运算（加法、乘法、BMI计算）
    • 气象数据模拟
    • 文本格式化实用程序
    • 时间和日期功能
  • 丰富的资源包括：
    • 应用程序配置
    • 个性化问候
    • 服务器信息
    • 数学常数
  • AI助手提示不同用例

安装脚本(src/setup_and_run.py)

  • 交互式设置和运行脚本
  • 自动依赖项安装
  • 多种运行选项（仅服务器、仅测试客户端或两者兼而有之）
  • 具有编号选项的用户友好界面

测试客户端(src/test_client.py)

  • 针对所有服务器功能的全面测试套件
  • 演示使用参数调用工具
  • 显示资源读取功能
  • 测试提示功能
  • 现代Python的Async/await实现

配置(src/mcp.json)

  • MCP服务器配置，便于集成
  • HTTP端点配置
  • 已准备好与MCP客户端一起使用

服务器功能

工具

  • add_numbers：将两个数字相加
  • 多个号码：将两个数字相乘
  • calculate_bmi：根据体重和身高计算BMI
  • get_weather：获取城市天气信息（模拟）
  • format_text：设置不同样式的文本格式（大写、小写、标题、反转）
  • get_current时间：获取指定时区的当前时间

资源

  • config://app：应用程序配置和状态
  • 问候语：//{姓名}：个性化问候
  • info://server：服务器信息和功能
  • math://constants：数学常数（π，e，黄金比例，√2）

提示

  • 计算器助理：有用的计算器助手
  • 天气助理：天气信息助理
  • 文本格式化器：文本格式化助手

建筑

该扩展使用FastMCP创建了一个现代的MCP（模型上下文协议）服务器结构：

  • FastMCP框架：基于装饰器的现代MCP服务器实现
  • HTTP传输：使用可流式传输的http，便于测试和开发
  • Pydantic模型：工具参数和响应的类型安全数据模型
  • 异步支持：对现代Python开发的完全异步/等待支持
  • 综合测试：内置测试客户端，可立即验证

需求

  • VS代码1.74.0或更高版本
  • Node.js 16.x或更高版本
  • TypeScript 4.9.4或更高版本
  • 生成的MCP服务器的Python 3.8+

发展

建筑

npm run compile

观察变化

npm run watch

测试

  1. 按 F5 在VS代码中启动扩展开发主机
  2. 在新窗口中使用“创建MCP服务器”命令
  3. 测试生成的文件夹结构和代码
  4. 运行安装脚本以测试完整的工作流

贡献

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

许可证

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

MCP 服务器初始化器

一个VS Code扩展，用于创建具有即用型Python代码的MCP（模型上下文协议）服务器文件夹结构。

示例项目： 查看由本扩展生成的真实示例：我的mcp服务器 —— 该仓库展示了使用本扩展后你将获得的项目结构和功能。

功能特性

  • 创建完整的MCP服务器文件夹结构
  • 生成即用型Python代码，使用FastMCP
  • 支持VS Code和Cursor
  • 交互式文件夹命名与验证
  • 创建后自动打开文件夹
  • 包含工具、资源和提示功能

使用方法

  1. 打开VS Code或Cursor
  2. 打开要创建MCP服务器的工作区文件夹
  3. 打开命令面板（macOS上按 Cmd+Shift+P，Windows/Linux上按 Ctrl+Shift+P）
  4. 输入 "Create MCP Server" 并选择命令
  5. 在提示时输入文件夹名称
  6. 扩展将创建完整的文件夹结构并打开它

运行生成的MCP服务器

在生成的服务器文件夹中，依次运行以下命令：

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
mcp dev src/demo_server.py

生成的结构

<文件夹名称>/
├── src/
│   ├── components/
│   │   ├── __init__.py      # Components package initialization
│   │   ├── tools.py         # Tool functions and models
│   │   ├── resources.py     # Resource functions
│   │   └── prompts.py       # Prompt functions
│   ├── demo_server.py       # Main MCP server implementation
│   ├── setup_and_run.py     # Setup and run script
│   ├── test_client.py       # Test client for the server
│   ├── mcp.json            # MCP server configuration
│   └── README.md           # Server documentation
└── requirements.txt        # Python dependencies

生成的代码功能

服务器（src/server.py)

  • 使用FastMCP实现主MCP服务器
  • 用于文件系统访问的资源装饰器
  • 用于echo、system_info和文件操作的工具装饰器
  • 各种AI交互的快速装饰器

资源(src/resources.py)

  • 文件系统资源处理
  • 配置和API状态资源
  • 资源列表和阅读功能

工具(src/tools.py)

  • 用于测试的回声工具
  • 系统信息工具
  • 文件操作工具（列表、读取、写入）

提示(src/prompts.py)

  • 问候提示
  • 文件分析提示
  • 代码审查提示
  • 数据汇总提示

建筑

该扩展创建了一个标准的MCP（模型上下文协议）服务器结构：

  • 服务器：主FastMCP服务器，带有资源、工具和提示的装饰器
  • 资源：数据访问和内容管理
  • 工具：AI交互的功能实现
  • 提示：AI对话的模板定义

需求

  • VS代码1.74.0或更高版本
  • Node.js 16.x或更高版本
  • TypeScript 4.9.4或更高版本

发展

建筑

npm run compile

观察变化

npm run watch

测试

  1. 按 F5 在VS代码中启动扩展开发主机
  2. 在新窗口中使用“创建MCP服务器”命令
  3. 测试生成的文件夹结构和代码

贡献

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

许可证

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

相关 MCP