使用说明

MCP服务器v2.3-现代交互式CLI集合

现代互动平台 MCP（模型上下文协议）服务器 Vue CLI风格的多选界面 用于专门的快速处理、容器化和现代web开发。

2.3版本功能

新增：8台专用服务器

Erlang OTP：GenServer、监控器、容错模式
灵药：函数式编程、并发、OTP行为
凤凰框架：控制器、路由、上下文、插头
凤凰频道：WebSocket、PubSub、状态跟踪
凤凰城LiveView：实时UI、钩子、HEEx模板、流
Neo4j：密码查询、图建模、路径模式
Qdrant：矢量搜索、RAG模式、相似性查询
HTMX+Axum：具有Rust后端的超媒体驱动UI

配置安装程序

新 install_mcp_configs.py 脚本会自动将所有服务器安装到：

克劳德桌面版
克劳德代码
Gemini CLI
反重力
VSCode内部人员

概述

MCP服务器是基于MCP（模型上下文协议）的19个专用服务器的集合，为快速分析、代码优化和现代开发工作流程提供工具。

主要特点

19个功能强大的MCP服务器，涵盖前端、后端、数据库和DevOps
具有Vue CLI风格界面的交互式多选CLI
主要AI工具的自动配置安装程序
0-100代码分析评分系统
具有模式和最佳实践的知识库

可用服务器（19/19功能正常）

分析服务器

服务器	端口	描述
`mcp`	3050	MCP提示分析，1-10分
`prompt`	3051	CRISPE/RACE框架的快速工程
`fastmcp`	3053	MCP开发的高性能元服务器

前端服务器

服务器	端口	描述
`tailwind`	3052	顺风CSS v4.1支持和迁移
`react`	3054	React 19功能（服务器组件、操作）
`shadcn`	3056	高级shadcn/ui组件开发
`htmx`	3068	HTMX与Axum（Rust）后端集成

后端服务器

服务器	端口	描述
`typescript`	3055	使用干净架构的TypeScript分析
`rust`	3057	惯用Rust模式（mre/惯用Rust）
`axum`	3058	Axum网络框架与tokio
`python`	3060	Python代码分析和现代范式

Elixir/Erlang生态系统

服务器	端口	描述
`erlang`	3061	Erlang/OTP模式、GenServer、监控器
`elixir`	3062	Elixir函数式编程和并发
`phoenix`	3063	Phoenix web框架（控制器、上下文）
`phoenix_channels`	3064	凤凰频道（WebSocket、PubSub、Presence）
`phoenix_liveview`	3065	Phoenix LiveView实时用户界面（挂钩，HEEx）

数据库服务器

服务器	端口	描述
`neo4j`	3066	Neo4j Cypher查询和图建模
`qdrant`	3067	Qdrant矢量搜索和RAG模式

DevOps服务器

服务器	端口	描述
`docker`	3059	Docker优化与安全最佳实践

安装

先决条件

Python 3.12+
uv（通用Python包管理器）

快速设置

# Clone the repository
git clone https://github.com/user/mcp-servers.git
cd mcp-servers

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies and create virtual environment
uv sync

# Modern interactive CLI (recommended)
uv run mcp_servers

# Show server status
uv run mcp_servers --status

# Traditional command-line
uv run python main.py --help

安装到AI工具

# Install all servers to Claude Desktop, Claude Code, Gemini CLI, etc.
uv run python install_mcp_configs.py --all

# Install to specific tool
uv run python install_mcp_configs.py --claude-desktop
uv run python install_mcp_configs.py --gemini-cli

# List configuration paths
uv run python install_mcp_configs.py --paths

快速使用

交互式CLI

# Launch interactive multi-select menu
uv run mcp_servers

# Or use the shell script
./run_servers.sh

直接命令

# Run specific server
uv run python main.py phoenix_liveview
uv run python main.py neo4j
uv run python main.py htmx

# Run multiple servers
uv run python main.py react tailwind shadcn

# Run all servers
uv run python main.py all --dev

# List all servers
uv run python main.py list

运行测试

# All tests
uv run pytest tests/ -v

# Specific server tests
uv run pytest tests/test_phoenix_liveview_server.py -v
uv run pytest tests/test_neo4j_server.py -v

服务器详细信息

Erlang OTP服务器(`erlang_server.py`)

为容错系统提供Erlang/OTP模式。

工具：

analyze_erlang_code -用评分分析Erlang代码
generate_otp_project -生成OTP项目结构
generate_genserver -生成GenServer模块
get_otp_patterns -按类别获取图案

Elixir服务器(`elixir_server.py`)

Elixir的函数式编程和并发模式。

工具：

analyze_elixir_code -分析Elixir代码
generate_elixir_project -生成混合项目
generate_genserver_elixir -生成GenServer模块
get_elixir_patterns -获取功能模式/OTP模式

Phoenix框架服务器(`phoenix_server.py`)

使用Phoenix控制器、路由和上下文进行Web开发。

工具：

analyze_phoenix_code -分析Phoenix代码
generate_phoenix_resource -生成CRUD资源
generate_context -生成Phoenix上下文
get_phoenix_patterns -获取控制器/路由器模式

Phoenix频道服务器(`phoenix_channels_server.py`)

使用WebSocket和PubSub进行实时通信。

工具：

analyze_channel_code -分析频道代码
generate_channel -生成通道模块
generate_socket -生成套接字模块
generate_presence -生成状态模块
get_channel_patterns -获取PubSub/Presence模式

Phoenix LiveView服务器(`phoenix_liveview_server.py`)

具有服务器渲染HTML的实时UI。

工具：

analyze_liveview_code -分析LiveView代码
generate_liveview -生成LiveView模块
generate_live_component -生成LiveComponent
generate_js_hook -生成JavaScript钩子
generate_liveview_form -生成带有验证的表单
get_liveview_patterns -获取生命周期/事件模式

Neo4j服务器(`neo4j_server.py`)

使用Cypher查询开发图形数据库。

工具：

analyze_cypher_query -分析Cypher查询
generate_cypher_query -生成密码查询
optimize_cypher -优化查询性能
generate_graph_model -生成图形模型
get_cypher_patterns -获取MATCH/CREATE模式

Qdrant服务器(`qdrant_server.py`)

矢量搜索和RAG（检索增强生成）模式。

工具：

analyze_qdrant_query -分析向量查询
generate_collection_config -生成集合配置
generate_qdrant_query -生成搜索查询
optimize_vector_search -优化搜索性能
get_qdrant_patterns -获取搜索/筛选模式

HTMX+Axum服务器(`htmx_server.py`)

使用Rust后端的超媒体驱动开发。

工具：

analyze_htmx_code -分析HTMX代码
generate_htmx_component -生成HTMX组件
generate_axum_handler -生成Axum处理程序
optimize_htmx_requests -优化请求模式
get_htmx_patterns -获取hx-*属性模式

项目结构

mcp-servers/
├── main.py                       # Unified launcher (v2.3)
├── launcher_cli.py               # Interactive CLI
├── install_mcp_configs.py        # Configuration installer
├── run_servers.sh                # Shell menu interface
├── pyproject.toml                # Project configuration
│
├── servers/                      # MCP servers (19 total)
│   ├── mcp_server.py            # MCP prompt analyzer
│   ├── prompt_server.py         # Prompt engineering
│   ├── tailwind_server.py       # Tailwind CSS v4.1
│   ├── fastmcp_server.py        # FastMCP meta-server
│   ├── react_server.py          # React 19 unified
│   ├── typescript_server.py     # TypeScript analysis
│   ├── shadcn_server.py         # shadcn/ui components
│   ├── rust_server.py           # Rust idiomatic
│   ├── axum_server.py           # Axum web framework
│   ├── docker_optimizer_server.py # Docker optimization
│   ├── python_optimizer_server.py # Python optimizer
│   ├── erlang_server.py         # Erlang/OTP (NEW)
│   ├── elixir_server.py         # Elixir (NEW)
│   ├── phoenix_server.py        # Phoenix Framework (NEW)
│   ├── phoenix_channels_server.py # Phoenix Channels (NEW)
│   ├── phoenix_liveview_server.py # Phoenix LiveView (NEW)
│   ├── neo4j_server.py          # Neo4j Cypher (NEW)
│   ├── qdrant_server.py         # Qdrant Vector (NEW)
│   └── htmx_server.py           # HTMX + Axum (NEW)
│
├── tests/                        # Test files (20 test files)
│   ├── test_mcp_server.py
│   ├── test_erlang_server.py    # NEW
│   ├── test_elixir_server.py    # NEW
│   ├── test_phoenix_server.py   # NEW
│   ├── test_phoenix_channels_server.py # NEW
│   ├── test_phoenix_liveview_server.py # NEW
│   ├── test_neo4j_server.py     # NEW
│   ├── test_qdrant_server.py    # NEW
│   ├── test_htmx_server.py      # NEW
│   └── ...
│
└── docs/                         # Documentation

MCP服务器配置格式

手动配置服务器时，请使用以下命令 正确的格式:

{
  "mcpServers": {
    "server-name": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/mcp-servers",
        "python",
        "-m",
        "servers.server_module"
      ],
      "env": {
        "MCP_SERVER_PORT": "3050",
        "MCP_SERVER_PROTOCOL": "stdio"
      }
    }
  }
}

重要提示：

--directory 必须指向 项目根目录，而不是 servers/ 子目录
使用 python -m servers.module_name 语法（模块），不是 server.py （文件）
这 env block是可选的，但建议用于显式端口配置

常见配置错误

错误	正确
`"--directory", "/path/servers"`	`"--directory", "/path/mcp-servers"`
`"run", "mcp_server.py"`	`"python", "-m", "servers.mcp_server"`
`--directory` 之前 `run`	`run`, `--directory`, ...

配置路径

配置安装程序支持：

工具	配置路径
克劳德桌面（macOS）	`~/Library/Application Support/Claude/claude_desktop_config.json`
克劳德代码	`~/.claude.json`
Gemini CLI	`~/.gemini/settings.json`
反重力	`~/.gemini/antigravity/mcp_config.json`
VSCode内部人员	`~/Library/Application Support/Code - Insiders/User/mcp.json`

评分系统

所有分析服务器都使用0-100评分系统：

分数	等级	描述
90-100	优秀	遵循所有最佳实践
75-89	良好	可能略有改进
50-74	需要改进	缺少重要模式
0-49	差	需要进行重大重构

故障排除

服务器意外断开连接

如果您看到以下错误：

Server transport closed unexpectedly, this is likely due to the process exiting early

解决：

检查一下 --directory 指向项目根（不是 servers/)
验证您是否使用了模块语法： python -m servers.module_name
跑 uv run python install_mcp_configs.py --claude-code 修复配置
配置更改后重新启动克劳德代码/桌面

找不到服务器/导入错误

# Test if a server can be imported
uv run python -c "from servers.mcp_server import mcp; print('OK')"

# Test MCP protocol initialization
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | \
  uv run python -m servers.mcp_server 2>/dev/null

查看服务器日志

克劳德桌面（macOS）: ~/Library/Logs/Claude/mcp*.log
克劳德桌面（Windows）: %APPDATA%\Claude\logs\mcp*.log

# macOS/Linux - follow logs
tail -f ~/Library/Logs/Claude/mcp*.log

重置配置

# Reinstall all configurations
uv run python install_mcp_configs.py --all

# Or specific tool
uv run python install_mcp_configs.py --claude-desktop
uv run python install_mcp_configs.py --claude-code

贡献

分叉项目
创建要素分支(git checkout -b feature/new-server)
为新功能添加测试
提交更改(git commit -m 'Add new server')
推送到分支(git push origin feature/new-server)
打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 LICENSE 文件以获取详细信息。

致谢

快速MCP -MCP服务器框架
派丹蒂克 -数据验证
紫外线 -Python包管理器
mre/习惯性生锈 -锈蚀模式
凤凰框架 -Elixir web框架

MCP服务器v2.3 | 19台服务器 | Python 3.12+ | 状态：生产

由Charleno Pires用爱开发

使用说明

MCP服务器v2.3-现代交互式CLI集合

2.3版本功能

新增：8台专用服务器

配置安装程序

概述

主要特点

可用服务器（19/19功能正常）

分析服务器

前端服务器

后端服务器

Elixir/Erlang生态系统

数据库服务器

DevOps服务器

安装

先决条件

快速设置

安装到AI工具

快速使用

交互式CLI

直接命令

运行测试

服务器详细信息

Erlang OTP服务器(erlang_server.py)

Elixir服务器(elixir_server.py)

Phoenix框架服务器(phoenix_server.py)

Phoenix频道服务器(phoenix_channels_server.py)

Phoenix LiveView服务器(phoenix_liveview_server.py)

Neo4j服务器(neo4j_server.py)

Qdrant服务器(qdrant_server.py)

HTMX+Axum服务器(htmx_server.py)

项目结构

MCP服务器配置格式

常见配置错误

配置路径

评分系统

故障排除

服务器意外断开连接

找不到服务器/导入错误

查看服务器日志

重置配置

贡献

许可证

致谢

相关 MCP

Figma MCP服务器

Markdown转换服务

MCP 协议测试服务器

代码索引分析工具

图像生成服务

代码安全扫描工具

Erlang OTP服务器(`erlang_server.py`)

Elixir服务器(`elixir_server.py`)

Phoenix框架服务器(`phoenix_server.py`)

Phoenix频道服务器(`phoenix_channels_server.py`)

Phoenix LiveView服务器(`phoenix_liveview_server.py`)

Neo4j服务器(`neo4j_server.py`)

Qdrant服务器(`qdrant_server.py`)

HTMX+Axum服务器(`htmx_server.py`)