Art Universe MCP Server

艺术宇宙MCP服务器

MCP服务器，用于深入分析和理解Art Universe项目，具有全面的数据库访问、Git集成和知识管理系统。

特性

分析工具：

1. load_project_context -加载完整的项目上下文
2. 分析模块 -分析模块结构和依赖关系
3. 分析数据库 -通过Liquibase迁移分析数据库模式
4. 分析测试 -分析测试覆盖率和原型
5. 分析梯度 -分析Gradle配置和依赖关系
6. 分析 -分析Git历史和当前状态
7. 分析api -分析REST API控制器和端点

数据库工具：

1. 列表_数据库 -列出所有可用的数据库连接
2. execute_sql -使用自动主机解析在指定数据库上执行SQL查询
3. list_tables -列出指定数据库架构中的表
4. describe_table -描述指定数据库中的表结构
5. get_environment_info -获取WSL检测和主机分辨率信息

Git工具：

1. git_status -获取已暂存、未暂存和未跟踪文件的详细git状态
2. git_公司历史 -获取git提交历史记录（单行或详细格式）
3. git_add_file -将文件添加到git暂存区（适用于WSL到Windows git！）
4. 使用 git_diff -显示文件的git diff（工作目录或阶段性更改）
5. git_commit_info -获取特定提交的详细信息

知识管理系统：

1. 获取所有知识 -获取所有项目知识（已批准+发现AI）
2. 获取_批准_知识 -只获取批准的项目知识
3. 获取知识 -只获取人工智能发现的知识
4. 添加知识 -添加人工智能发现的新知识
5. update_知识 -更新人工智能知识库中的现有知识
6. 移除知识 -从AI知识库中删除知识
7. 搜索知识 -搜索所有项目知识
8. 获取知识_设置 -获取知识库的统计数据

数据库管理

服务器通过自动WSL提供全面的PostgreSQL数据库访问↔ Windows主机分辨率：

数据库配置：

• 配置存储在 config/database-config.json
• 支持多种数据库环境（开发、暂存、生产）
• 自动本地主机→ WSL环境中的Windows主机IP解析

数据库连接：

• mu_raw_lastfm\_\_dev -开发数据库（原始LastFM数据）
• mu\_\_dev -开发数据库（批准的数据）
• mu_raw_lastfm\_\_产品 -旧生产数据库
• mu_raw_lastfm\_\_prod -新生产数据库（Raw LastFM）
• μprod -新生产数据库（已批准的数据）

使用示例：

# List all databases
list_databases

# Execute SQL query with index statistics
execute_sql database="mu_raw_lastfm__prod" query="SELECT schemaname, tablename, indexname, idx_scan FROM pg_stat_user_indexes ORDER BY idx_scan DESC LIMIT 10"

# List tables in specific schema
list_tables database="mu_raw_lastfm__dev" schema="mu_raw_lastfm"

# Describe table structure
describe_table database="mu_raw_lastfm__dev" table="artist" schema="mu_raw_lastfm"

# Check environment info
get_environment_info

Git集成

从WSL到Windows存储库无缝工作的完整Git集成：

Git功能：

• 状态跟踪 -已暂存/未暂存/未跟踪文件的详细状态
• 提交历史记录 -以多种格式浏览提交历史记录
• 文件管理 -从AI将文件添加到暂存区
• 不同视角 -查看工作目录或暂存区域中的更改
• 承诺检查 -获取有关特定提交的详细信息

使用示例：

# Get detailed git status
git_status

# View recent commit history
git_commit_history limit=10 format="detailed"

# Add AI-created files to git
git_add_files files=["new-feature.js", "documentation.md"]

# View changes in specific files
git_diff files=["src/index.ts"] staged=false

# Get information about a commit
git_commit_info commit="HEAD~1"

知识管理

该服务器包括一个复杂的知识管理系统：

知识档案：

• knowledge/approved-knowledge.md -开发人员认可的知识
• knowledge/ai-discovered-knowledge.md -人工智能发现了洞察力

使用示例：

# Get all knowledge
get_all_knowledge

# Add new discovery
add_knowledge "New Pattern" "Discovered interesting architectural pattern..." "ai_discovery"

# Search knowledge base
search_knowledge "Spring Boot"

# Get knowledge statistics
get_knowledge_stats

看 知识_系统.md 详细文档。

安装和设置

1.构建服务器

npm install
npm run build

2.配置数据库

将数据库配置复制到 config/database-config.json:

{
  "databases": {
    "your_db_key": {
      "name": "Database Name",
      "host": "localhost",
      "port": 5432,
      "database": "database_name",
      "username": "username",
      "password": "password",
      "type": "local"
    }
  }
}

3.添加到Q CLI

MCP服务器配置在：

• ~/.config/q/mcp.json （全球）
• .q/mcp.json （项目本地）

4.重新启动Q CLI

添加配置后，重新启动Q CLI：

q chat

WSL↔ Windows集成

服务器会自动检测WSL环境并解析Windows主机连接：

自动功能：

• WSL检测 -自动检测是否在WSL中运行
• 主机解析 -转换 localhost 到WSL中的Windows主机IP
• 数据库连接 -从WSL无缝连接到Windows PostgreSQL
• Git集成 -从WSL到Windows存储库的完整Git功能

环境检测：

# Check current environment
get_environment_info

项目结构

art-universe-mcp-server/
├── src/                   # Source code
│   ├── analyzers/          # Analysis modules
│   │   ├── DatabaseConnector.ts
│   │   ├── GitAnalyzer.ts
│   │   └── ...
│   ├── utils/
│   │   └── HostResolver.ts # WSL/Windows host resolution
│   └── index.ts           # Main MCP server
├── config/
│   └── database-config.json # Database configuration
├── test/                  # Test files
├── dist/                  # Compiled files
└── README.md

路径解析

MCP服务器使用动态路径解析：

• 服务器配置：从服务器自己的目录加载(config/database-config.json)
• 知识档案：从调用服务器的工作目录加载(knowledge/)
• 项目分析：在工作目录（Git、模块等）上执行

这允许从任何项目目录调用服务器，同时保持其自己的配置。

使用模式：

# From your project directory (contains knowledge/)
cd /path/to/your/project

# Call the MCP server from anywhere
node /path/to/art-universe-mcp-server/dist/index.js

测试

运行测试：

# Test all database connections
node test/test-all-connections.js

# Test Git functionality
node test/test-git-functionality.js

# Test MCP tools
node test/test-mcp-tools.js

测试结果：

所有工具都经过测试，工作正常：

• ✅ 数据库工具 -具有WSL支持的完全PostgreSQL访问权限
• ✅ Git工具 -从WSL到Windows的完整Git集成
• ✅ 分析工具 -综合项目分析
• ✅ 知识管理 -人工智能知识积累系统

发展

开发命令：

# Development with auto-reload
npm run dev

# Build
npm run build

# Start
npm start

添加新工具：

1. 在中添加工具定义 src/index.ts （ListToolsRequestSchema处理程序）
2. 在中添加工具处理程序 src/index.ts （CallToolRequestSchema处理程序）
3. 在适当的分析仪中实现功能
4. 在中添加测试 test/ 目录
5. 更新README.md

后续步骤

1. 重新启动Q CLI 加载更新的MCP服务器
2. 测试数据库连接 使用 list_databases 和 execute_sql
3. 尝试Git集成 随着 git_status 和 git_commit_history
4. 使用知识管理 用于项目理解

MCP服务器提供全面的项目理解，具有完整的数据库访问、Git集成和知识管理功能，可在WSL和Windows环境中无缝工作。