使用说明

MCP发射器🚀

一个全面的模型上下文协议（MCP）开发环境，可实现人工智能增强工具的快速原型制作和部署。该启动器为构建自定义MCP服务器和将外部服务与Claude AI集成提供了基础。

🎯 概述

MCP Launcher遵循模块化的“3D打印机”理念——从基本功能开始，并使用它们构建越来越复杂的工具。目前包括文件系统操作、开发脚手架和Discord集成框架。

✨ 特性

🔧 核心基础设施

MCP服务器管理 -自动服务器发现和注册
环境配置 -基于模板的设置，具有安全的凭据管理功能
开发工具 -热重新加载、调试和测试实用程序
与跨平台支持 -具有可扩展架构的Windows批处理脚本

📁 内置功能

增强的文件系统 -高级文件操作、搜索和分析
数据科学工具 -项目脚手架、CSV分析、Jupyter笔记本生成
开发自动化 -包创建、依赖关系管理、.gitignore生成
电源平台集成 -Power BI模板和DAX生成

🔌 自定义服务器框架

Discord集成 （开发中）-消息阅读、渠道管理、分析
模块化架构 -轻松添加新的服务集成
工具注册系统 -自动工具发现和分类

🚀 快速开始

先决条件

Node.js 18+
克劳德桌面应用程序
Git（用于克隆和开发）

安装

克隆存储库：

git clone https://github.com/yourusername/mcp_launcher.git
cd mcp_launcher

设置环境：

# Copy template and configure
copy .env.template .env
# Edit .env with your paths and tokens

安装依赖项：
```
npm install
```

构建所有服务器：

# Windows
SetupLocal.bat

# Manual build
cd custom-servers/enhanced-filesystem && npm install && npm run build
cd ../discord && npm install && npm run build

使用MCP启动Claude：
```
LaunchClaude.bat
```

第一步

在Claude中尝试以下命令以测试您的设置：

"Create a data science project called 'test_project' of type 'analysis'"
"List all files in my current directory"
"Generate a Python .gitignore file"

📁 项目结构

mcp_launcher/
├── custom-servers/           # MCP server implementations
│   ├── enhanced-filesystem/  # Core filesystem and data tools
│   └── discord/             # Discord integration (in development)
├── extensions/              # Extension configurations
├── system/                  # Core launcher system
│   ├── bootstrap.js         # MCP server initialization
│   ├── mcp_config.json     # Server registry
│   └── startup_config.json # Launch configuration
├── .env.template           # Environment variable template
├── LaunchClaude.bat       # Main launcher script
└── SetupLocal.bat         # Initial setup script

🛠️ 发展

添加新的MCP服务器

创建服务器目录：

mkdir custom-servers/my-new-server
cd custom-servers/my-new-server
npm init -y

安装MCP SDK：

npm install @modelcontextprotocol/sdk
npm install -D typescript @types/node

创建服务器实现：

// src/index.ts
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
// ... implement your server

在配置中注册：

// system/mcp_config.json
{
  "my-new-server": {
    "command": "node",
    "args": ["custom-servers/my-new-server/dist/index.js"]
  }
}

Discord集成开发

Discord服务器框架已准备好进行工具实施：

// Example: custom-servers/discord/src/tools/messaging/send-message.ts
import { BaseDiscordTool } from '../base-discord-tool.js';

export class SendMessageTool extends BaseDiscordTool {
  name = 'discord_send_message';
  description = 'Send a message to a Discord channel';
  category = 'messaging';
  
  async execute(args: { channel_id: string; message: string }) {
    // Implementation here
  }
}

🔧 配置

环境变量

复制 .env.template 向 .env 并配置：

# User Configuration
USER_HOME="C:\\Users\\YourName"
CLAUDE_DOCS_PATH="C:\\Users\\YourName\\Documents\\Claude"
CLAUDE_APP_PATH="C:\\Users\\YourName\\AppData\\Local\\AnthropicClaude\\Claude.exe"

# MCP Settings
MCP_FILESYSTEM_ENABLED=true
MCP_FILESYSTEM_PATHS="C:\\Users\\YourName\\Documents\\Claude"

# Service Integrations
GITHUB_TOKEN=your_github_token_here
DISCORD_BOT_TOKEN=your_discord_bot_token_here
DISCORD_CLIENT_ID=your_discord_client_id

安全说明

永不承诺 .env 文件（已在.gitignore中）
使用 .env.template 记录所需变量
仅在环境变量中存储敏感令牌

🎯 用例

数据科学工作流程

结构合理的快速项目脚手架
CSV分析和数据分析
使用模板生成Jupyter笔记本
Power BI集成用于可视化

开发自动化

创建具有适当结构的包
依赖关系管理和需求生成
代码分析和文档
Git工作流自动化

服务集成

Discord机器人管理和分析
GitHub存储库操作
API测试和文件编制
跨平台的工作流自动化

🤝 贡献

分叉存储库
创建要素分支： git checkout -b feature/amazing-feature
提交更改： git commit -m 'Add amazing feature'
推送到分支： git push origin feature/amazing-feature
打开拉取请求

开发指南

遵循模块化架构模式
添加全面的工具文档
包括错误处理和验证
使用真实场景进行测试
根据需要更新配置模板

📚 资源

模型上下文协议 -MCP官方文件
MCP TypeScript SDK -SDK参考
克劳德桌面 -Claude桌面应用程序
Discord.js -Discord API包装

🐛 故障排除

常见问题

MCP服务器未加载：

检查服务器版本： npm run build 在服务器目录中
验证中的路径 system/mcp_config.json
检查控制台输出 LaunchClaude.bat

权限错误：

确保Claude可以访问配置的文件系统路径
检查批处理脚本的Windows执行策略
验证环境变量路径是否正确

Discord集成：

验证机器人令牌和权限
检查公会ID配置
确保机器人已添加到目标服务器

调试模式

通过在启动期间修改服务器配置或检查控制台输出来启用详细日志记录。

📄 许可证

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

🙏 致谢

Claude的拟人化和MCP框架
开源社区，提供工具和灵感
贡献者和测试者