Portable MCP Toolkit

MCPAI代理

提供方 mjdevaccount

AI代理 stdio · 本地进程 Token 社区 / 第三方 ClaudeCursorVS Code
查看接入方式

AIStack-MCP是一款企业级MCP编排工具,提供本地优先、生产就绪的双模式(单仓库隔离与多仓库协调)开发环境,比纯云方案节省90%成本。

一句话选型结论

按资料字段整理

Portable MCP Toolkit 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude、Cursor、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量6暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP编排Python本地部署双模式开发本地AI代码智能企业级工具

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m venv .venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Portable MCP Toolkit当前 6 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mjdevaccount上游标注的维护方 mjdevaccount
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

27.5 KB
来自项目仓库与上游目录的原文,未做删改

🚀 AIStack MCP

面向现代发展的企业级MCP编排

双模MCP编排解决了隔离与协调的困境——本地优先,生产就绪,比纯云方法便宜90%。


📊 当前状态(v1.2.0)

最新版本: v1.2.0--MCP注册表集成和模板系统

v1.2.0的新增功能

功能 状态 描述
🗂️ MCP注册表 ✅ 新 浏览并安装500多个社区MCP服务器
📋 模板系统 ✅ 新 预构建配置(最小、标准、完整)
🔧 服务器安装程序 ✅ 新 npm/PyPI/Docker服务器的一个命令安装
🔍 注册表搜索 ✅ 新 按关键字、类别、运行时搜索
🧠 代码智能 ✅ 稳定 语义搜索、模式分析、代码生成
🔄 双模 ✅ 稳定 单仓库隔离和多仓库编排
✅ 88测试通过 ✅ 稳定 全面测试覆盖

快速统计

  • 社区服务器:500+可通过注册表获得
  • 模板:3种预构建配置
  • 测试覆盖率:88个单元测试通过
  • 文档:15+指南和故障排除文档
  • 生产就绪:CI/CD验证,企业测试

💡 为何这很重要

> 问题: MCP服务器需要仔细隔离以确保安全,但现代开发通常跨越多个存储库。你不得不在两者之间做出选择 安全隔离 (一次一个回购)或 生产力 (交叉回购情报)。
>
> 解决方案: AIStack MCP提供 双模编排--使用单个命令在隔离的单回购模式和协调的多回购模式之间切换。两全其美。

关键差异化因素

是什么让它与众不同?为什么它很重要
🔄 一种命令模式切换 · 以秒而非分钟为单位切换上下文
🏗️ 2025种经过验证的模式 · Git多仓库支持,MCP协调
🔒 生产就绪安全 · 工作区隔离,明确权限
💰 成本降低90% · 本地LLM+矢量搜索=免费情报
✅ 企业验证 · CI就绪脚本、健康检查、监控


📑 目录

  • ✨ 特性
  • 🏗️ 建筑
  • 🚀 快速开始
  • 📦 安装
  • 🔄 操作模式
  • 📖 使用指南
  • 📁 项目结构
  • 🛠️ 工具参考
  • ⚡ 性能和成本
  • 🔧 故障排除
  • ❓ 常见问题解答
  • 🎓 高级主题
  • 🗺️ 路线图
  • 🤝 贡献
  • 📄 许可证

✨ 特性

核心能力

特性 描述
🔒 单一回购隔离 便携式 ${workspaceFolder} 每个项目权限的最大安全配置
🌐 多回购业务流程 跨仓库语义搜索、统一上下文、CORE工作区协调
⚡ 一个命令切换 switch_to_single_repo.ps1 / switch_to_multi_repo.ps1 具有自动验证功能
🩺 健康监测 实时服务检查、依赖性验证、配置验证
🧠 本地第一AI Ollama(LLM推理)+Qdrant(向量搜索)=100%本地,100%私有
💰 成本降低90% 使用本地AI进行预处理,仅将压缩的上下文发送给Claude
🌍 通用兼容性 适用于Python、TypeScript、Rust、Go、Java——任何语言、任何框架

开发者体验

特性 描述
🧙 交互式安装向导 quickstart.ps1 引导新用户完成整个设置
🔍 CI就绪验证 validate_mcp_config.py 随着 --strict 零预警构建模式
📊 开发环境仪表板 dev_all.ps1 一目了然地显示服务状态、模型、集合
📚 综合文档 故障排除指南、最佳实践、实际示例
🏭 生产测试图案 来自企业部署的久经考验的配置

🏗️ 建筑```

┌─────────────────────────────────────────────────────────────────────┐
│ YOUR CODEBASE │
│ (Any Language • Any Framework • Any Size) │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ AISTACK-MCP ORCHESTRATION LAYER │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────┐ │
│ │ Filesystem │ │ Git │ │ Code Intelligence │ │
│ │ MCP │ │ MCP │ │ MCP │ │
│ │ (Read/Write) │ │ (History/Diff) │ │ (Search/Analyze) │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Mode Orchestrator: Single-Repo ←→ Multi-Repo Switching │ │
│ └─────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ LOCAL AI STACK (FREE) │
│ │
│ ┌─────────────────────────┐ ┌─────────────────────────────┐ │
│ │ OLLAMA │ │ QDRANT │ │
│ │ • LLM Inference │ │ • Vector Search │ │
│ │ • Pattern Analysis │ │ • Semantic Indexing │ │
│ │ • Code Generation │ │ • 90% Token Compression │ │
│ └─────────────────────────┘ └─────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ CURSOR + CLAUDE │
│ (Final Generation Only • Minimal Token Usage) │
└─────────────────────────────────────────────────────────────────────┘


### 数据流和成本节约

1. **你问了一个问题** → 游标收到您的提示
1. **先本地搜索** → Qdrant查找相关代码块(免费)
1. **局部压缩** → Ollama总结上下文(免费)
1. **最小传输** → 仅向Claude发送了500-1000个代币
1. **最终世代** → 克劳德完全理解

**结果:** 令牌减少90%,质量相同,本地处理100%隐私。

______________________________________________________________________

## 🚀 快速开始

### 路径1:新用户(推荐)```powershell
# Clone and run the interactive wizard
git clone https://github.com/mjdevaccount/AIStack-MCP.git
cd AIStack-MCP
.\scripts\quickstart.ps1

向导会自动执行以下操作:

  • ✅ 检查所有依赖关系
  • ✅ 引导模式选择
  • ✅ 配置服务
  • ✅ 验证设置

路径2:经验丰富的用户

📋 Click to expand manual setup```powershell

1. Clone repository

git clone https://github.com/mjdevaccount/AIStack-MCP.git
cd AIStack-MCP

2. Install Python dependencies

python -m venv .venv
..venv\Scripts\Activate.ps1
pip install -r requirements.txt

3. Start services

ollama serve # Terminal 1
docker run -d -p 6333:6333 qdrant/qdrant # Terminal 2

4. Pull required models

ollama pull mxbai-embed-large
ollama pull qwen2.5:7b

5. Configure mode

.\scripts\switch_to_single_repo.ps1

6. Open in Cursor

cursor .


### 路径3:CI/CD集成```yaml
# .github/workflows/validate.yml
- name: Validate MCP Configuration
run: |
python scripts/validate_mcp_config.py --test-generation --strict

🌐 社区工具(v1.2.0)

浏览500多台MCP服务器

搜索工具```powershell
.\scripts\list_registry_tools.ps1 -Search "database"


热门服务器```powershell
.\scripts\list_registry_tools.ps1 -Popular

安装社区工具

安装PostgreSQL服务器```powershell
.\scripts\install_community_tool.ps1 -ServerId "io.modelcontextprotocol/server-postgres"


安装Slack集成```powershell
.\scripts\install_community_tool.ps1 -ServerId "io.modelcontextprotocol/server-slack"

应用模板

最小(仅搜索)```powershell
.\scripts\apply_template.ps1 -Template minimal


标准(推荐)```powershell
.\scripts\apply_template.ps1 -Template standard

完整(所有功能)```powershell
.\scripts\apply_template.ps1 -Template full


看 注册表文件 完整指南。

______________________________________________________________________

## 📦 安装

### 系统要求

|要求|最低要求|建议|
|-------------|---------|-------------|
| **操作系统** |Windows 10 | Windows 11|
| **python** | 3.8 | 3.11+ |
| **Node.js** |18.x | 20.x LTS|
| **随机存取存储器** |8 GB | 16 GB|
| **磁盘** |10 GB | 20 GB(适用于型号)|
| **码头工人** |可选|推荐|

### 第一步:先决条件```powershell
# Install Node.js (for MCP community servers)
winget install OpenJS.NodeJS

# Install Python (if not present)
winget install Python.Python.3.11

# Verify installations
node --version   # Should show v18+
python --version # Should show 3.8+

第二步:Python依赖关系```powershell

cd C:\AIStack-MCP

Create virtual environment

python -m venv .venv
..venv\Scripts\Activate.ps1

Install dependencies

pip install -r requirements.txt


### 第三步:本地人工智能服务

🦙 Ollama Setup

1. 下载自 奥拉玛
1. 安装并启动服务
1. 拉动所需型号:```powershell
ollama pull mxbai-embed-large  # Required: embeddings
ollama pull qwen2.5:7b         # Recommended: analysis
ollama pull phi4:14b           # Optional: code generation
  1. 验证:```powershell
    ollama list

🔍 Qdrant Setup

**选项A:Docker(推荐)**```powershell
docker run -d -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant

选项B:本机安装

  • 下载自 qdrant.tech

验证:```powershell
curl http://localhost:6333/collections


### 步骤4:配置```powershell
# Run the quickstart wizard (recommended)
.\scripts\quickstart.ps1

# Or manually configure single-repo mode
.\scripts\switch_to_single_repo.ps1

> 💡 提示: 如果Cursor在启动时挂起,请确保您正在使用 cmd /c 包装图案。看 Windows MCP修复程序.


🔄 操作模式

模式比较

功能 单回购模式 多回购模式
孤立 ✅ 最大值(每个回购) ⚠️ 共享(核心访问)
可移植性 ✅ ${workspaceFolder} ✅ 相对路径
安全 ✅ 显式权限 ⚠️ CORE拥有所有访问权限
跨回购搜索 ❌ 只有一个回购 ✅ 所有链接的仓库
设置复杂性 ⭐ 简单 ⭐⭐ 需要链接
最适合 专注工作、安全 多包、微服务

切换模式```powershell

Switch to single-repo (isolated, portable)

.\scripts\switch_to_single_repo.ps1

Switch to multi-repo (orchestrated)

.\scripts\switch_to_multi_repo.ps1

Check current mode

Get-Content .cursor\ACTIVE_MODE.txt


### 多回购设置```powershell
# 1. Link repositories (requires Admin for symlinks)
.\scripts\link_repo.ps1 -TargetPath "C:\Projects\backend-api"
.\scripts\link_repo.ps1 -TargetPath "C:\Projects\frontend-app"

# 2. Or clone directly (no Admin required)
.\scripts\link_repo.ps1 -TargetPath "https://github.com/org/repo" -Clone

# 3. Activate multi-repo mode
.\scripts\switch_to_multi_repo.ps1

# 4. Restart Cursor

📖 使用指南

场景1:首次设置```powershell

1. Run quickstart wizard

.\scripts\quickstart.ps1

2. Open project in Cursor

cursor C:\AIStack-MCP

3. In Cursor chat, index your workspace

Use code-intelligence to index_workspace

4. Verify setup

Use code-intelligence to validate_workspace_config


**预期产量:**```
✅ Workspace: C:\AIStack-MCP (accessible)
✅ Ollama: Connected (3 models available)
✅ Qdrant: Connected (1 collection indexed)
✅ Configuration: Valid

场景2:日常开发```

Semantic search (find code by meaning)

Use code-intelligence to semantic_search for "error handling patterns"

Pattern analysis (extract patterns with LLM)

Use code-intelligence to analyze_patterns for "async"

Get optimized context for a file

Use code-intelligence to get_context for src/utils.py with task "add retry logic"

Generate code matching project style

Use code-intelligence to generate_code for src/api.py with task "add pagination"


### 场景3:多回购开发```powershell
# Morning: Link all related repos
.\scripts\link_repo.ps1 -TargetPath "C:\Projects\shared-libs"
.\scripts\link_repo.ps1 -TargetPath "C:\Projects\backend"
.\scripts\link_repo.ps1 -TargetPath "C:\Projects\frontend"

# Activate multi-repo mode
.\scripts\switch_to_multi_repo.ps1

# Now in Cursor: search across ALL linked repos
Use code-intelligence to semantic_search for "authentication flow"

场景4:团队入职

与新团队成员共享以下命令:```powershell

Complete setup in one command

git clone https://github.com/your-org/AIStack-MCP.git
cd AIStack-MCP
.\scripts\quickstart.ps1


参考: docs/BEST_PRACTICES.md

______________________________________________________________________

## 📁 项目结构```
AIStack-MCP/
├── .cursor/
│   ├── mcp.json                  # 🎯 Active MCP configuration
│   └── ACTIVE_MODE.txt           # 📍 Current mode indicator
│
├── docs/
│   ├── WORKSPACE_PATTERN.md      # 📐 Isolation best practices
│   ├── BEST_PRACTICES.md         # 👥 Team usage guidelines
│   ├── SETUP.md                  # 📋 Detailed setup guide
│   └── troubleshooting/          # 🔧 Platform-specific fixes
│       ├── WINDOWS_MCP_FIX.md
│       └── MCP_TROUBLESHOOTING.md
│
├── scripts/
│   ├── quickstart.ps1            # 🌟 Interactive setup wizard
│   ├── switch_to_single_repo.ps1 # 🔒 Activate isolated mode
│   ├── switch_to_multi_repo.ps1  # 🌐 Activate orchestration mode
│   ├── link_repo.ps1             # 🔗 Repository linking helper
│   ├── validate_mcp_config.py    # ✅ CI-ready validation
│   ├── validate_workspace.py     # 🩺 Workspace diagnostics
│   ├── dev_all.ps1               # 📊 Dev environment status
│   └── mcp_config_builder.py     # 🏗️ Config generator
│
├── workspaces/                   # 📂 Multi-repo links (gitignored)
│   └── README.md
│
├── python_agent/                 # 🤖 Agent implementation
│   ├── agents/
│   ├── tools/
│   └── mcp_production_server.py
│
├── mcp_intelligence_server.py    # 🧠 Main MCP server
├── requirements.txt              # 📦 Python dependencies
├── docker-compose.yml            # 🐳 Service orchestration
└── README.md                     # 📖 You are here

🛠️ 工具参考

可用的MCP工具

工具 描述 示例 成本
semantic_search 使用向量相似度按含义查找代码 semantic_search for "retry logic" 免费
analyze_patterns 使用本地LLM提取模式 analyze_patterns for "error handling" 免费
get_context 获取任务的优化上下文 get_context for utils.py 免费
generate_code 生成与项目样式匹配的代码 generate_code for api.py 免费
index_workspace 构建向量索引(运行一次) index_workspace 免费
validate_workspace_config 健康检查和诊断 validate_workspace_config 免费

何时使用每种工具

任务 推荐工具 为什么
“X在哪里实现?” semantic_search 按含义查找,而不是按精确文本查找
“Y有什么模式?” analyze_patterns LLM摘录和总结
“我需要修改文件Z” get_context 提供优化的上下文
“向文件W添加功能” generate_code 匹配现有样式
“我的设置正确吗?” validate_workspace_config 全面诊断

⚡ 性能和成本

现实世界指标

度量 不使用AIStack 使用AIStack 改进
每个请求的令牌 50000 5000 减少90%
API月度成本 $100-150 $20 节省80-130美元
搜索延迟 N/A \<100ms 即时结果
上下文准确性 变量 优化 更好的响应
数据隐私 云处理 本地优先 100%私有

成本细分```

WITHOUT AISTACK-MCP:
├── Cursor reads 5,000 tokens/file
├── 10 files per request = 50,000 tokens
├── ~100 requests/day = 5M tokens
└── Monthly cost: $100-150

WITH AISTACK-MCP:
├── Local search finds relevant code (FREE)
├── Local LLM compresses to 500 tokens (FREE)
├── Only compressed context sent to Claude
└── Monthly cost: ~$20 (Cursor subscription only)

SAVINGS: $80-130/month per developer


### 内存占用

|组件|内存使用情况|
|-----------|--------------|
|Ollama(空闲)|~500 MB|
|奥利玛(推理)|4-8GB|
|Qdrant |约200 MB|
|MCP服务器|总计约100 MB|

______________________________________________________________________

## 🔧 故障排除

### 问题:启动时光标崩溃或挂起(Windows)

**症状:** MCP服务器启动时光标冻结,或立即崩溃。

**原因:** Windows STDIO传输与Python不兼容。

**解决方案:**```json
// Use cmd /c wrapper in .cursor/mcp.json
{
&quot;command&quot;: &quot;cmd&quot;,
&quot;args&quot;: [&quot;/c&quot;, &quot;python&quot;, &quot;...&quot;]
}

验证: .\scripts\switch_to_single_repo.ps1 生成正确的配置。

📖 完整指南


问题:MCP服务器未出现

症状: Cursor聊天中没有可用的MCP工具。

原因: Cursor未加载配置。

解决方案:

  1. 完全重新启动游标(关闭所有窗口)
  2. 检查 .cursor/mcp.json 存在
  3. 查看日志:帮助→ 切换开发人员工具→ 控制台

验证:```powershell
python scripts\validate_mcp_config.py


______________________________________________________________________

### 问题:语义搜索返回空

**症状:** `semantic_search` 不返回任何结果。

**原因:** 工作区未编入索引。

**解决方案:**```
Use code-intelligence to index_workspace

验证: 查看Qdrant收藏 http://localhost:6333/dashboard


问题:Ollama连接失败

症状: “无法连接到Ollama”错误。

原因: Ollama服务未运行。

解决方案:```powershell

Start Ollama

ollama serve

Verify

ollama list


______________________________________________________________________

### 问题:模式切换未生效

**症状:** 配置更改不适用。

**原因:** 游标缓存MCP配置。

**解决方案:**

1. 跑 `.\scripts\switch_to_*.ps1`
1. **完全重新启动Cursor** (不仅仅是重新加载)
1. 检查 `.cursor/ACTIVE_MODE.txt`

📖 更多故障排除

______________________________________________________________________

## ❓ 常见问题解答

How is this different from GitHub Copilot?

Copilot提供在线完井。AIStack MCP提供:

- **语义搜索** 在整个代码库中
- **模式分析** 使用本地LLM
- **交叉回购情报** 在多回购模式下
- **成本降低90%** 通过局部预处理
- **100%隐私** 用于本地处理

它们相辅相成——两者兼得!

Why local-first instead of cloud-only?

- **成本:** 本地LLM推理是免费的
- **隐私:** 代码永远不会离开你的机器进行搜索/分析
- **速度:** 矢量搜索与网络延迟相比\&lt;100ms
- **可利用性:** 索引后脱机工作

Can I use this with VS Code?

目前已针对Cursor IDE进行了优化。VS Code支持已在路线图上(v1.1)。

What languages are supported?

全部!该系统适用于任何基于文本的代码:

- Python、JavaScript、TypeScript
- Rust、Go、Java、C#、C++
- Ruby、PHP、Swift、Kotlin
- 还有更多。..

Is this production-ready?

对。AIStack MCP包括:

- CI就绪验证脚本
- 全面的错误处理
- 健康监测
- 生产测试配置
- 企业安全模式

What about security?

- **单回购模式:** 每个项目权限的最大隔离
- **多回购模式:** 需要显式链接,控制CORE工作区
- **本地处理:** 敏感代码永远不会离开你的机器
- **审计跟踪:** `.cursor/ACTIVE_MODE.txt` 跟踪模式更改

看 docs/BEST_PRACTICES.md 安全指南。

Can teams use this?

当然!共享存储库并让团队成员运行:```powershell
.\scripts\quickstart.ps1

看 docs/BEST_PRACTICES.md 用于团队工作流程。

How do I update to new versions?```powershell
git pull origin main
pip install -r requirements.txt --upgrade
.\scripts\switch_to_single_repo.ps1 # Regenerate config


______________________________________________________________________

## 🎓 高级主题

### 1.多回购编排模式

何时使用多重回购模式:

- Python多包项目
- 微服务架构
- 具有独立仓库的Monrepo风格开发

**链接策略:**

- **符号链接:** 最适合当地发展(需要管理员)
- **克隆:** 无需管理员,独立副本
- **子模块:** 版本控制链接

📖 完整指南

### 2.CI/CD集成```yaml
# .github/workflows/validate.yml
name: Validate MCP Config
on: [push, pull_request]
jobs:
validate:
runs-on: windows-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: &#x27;3.11&#x27;
- run: pip install -r requirements.txt
- run: python scripts/validate_mcp_config.py --test-generation --strict

3.定制工具开发

扩展 mcp_intelligence_server.py:```python
@mcp.tool()
async def my_custom_tool(query: str) -> str:
"""Your custom tool description."""

Implementation

return result


### 4.团队工作流程

模式选择决策树:```
Working on ONE repo? → Single-repo mode
Working on 2-5 related repos? → Multi-repo mode
Working on 6+ repos? → Split into focused workspaces

📖 完整指南

5.生产部署```yaml

docker-compose.yml (included)

services:
qdrant:
image: qdrant/qdrant
ports:
- "6333:6333"
volumes:
- qdrant_storage:/qdrant/storage


______________________________________________________________________

## 🗺️ 路线图

### v1.2.0--当前版本✅

- ✅ MCP注册表集成(浏览500多个社区服务器)
- ✅ 模板系统(最小、标准、完整)
- ✅ 服务器安装程序(npm、PyPI、Docker)
- ✅ 社区工具管理脚本
- ✅ 双模式编排(单/多仓库)
- ✅ 完整的验证套件
- ✅ 交互式设置向导
- ✅ 生产就绪模式
- ✅ 全面的文件

### v1.3.0--计划中

- 🔲 VS代码扩展支持
- 🔲 额外的LLM后端(克劳德本地,GPT4All)
- 🔲 增强的缓存层
- 🔲 仪表盘

### v2.0.0--未来

- 🔲 可选云同步
- 🔲 团队协作功能
- 🔲 管理员仪表板
- 🔲 使用情况分析

______________________________________________________________________

## 🤝 贡献

我们欢迎捐款!以下是如何开始:

### 报告Bug

打开一个问题 与:

- 问题的清晰描述
- 重现步骤
- 预期行为与实际行为
- 系统信息(操作系统、Python版本等)

### 功能请求

展开讨论 以提出新功能。

### 开发设置```powershell
# Fork and clone
git clone https://github.com/YOUR_USERNAME/AIStack-MCP.git
cd AIStack-MCP

# Install dependencies
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

# Run validation
python scripts\validate_mcp_config.py --test-generation

拉取请求流程

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 进行更改
  4. 运行验证(python scripts\validate_mcp_config.py --strict)
  5. 承诺(git commit -m &#x27;feat: Add amazing feature&#x27;)
  6. 推(git push origin feature/amazing-feature)
  7. 打开拉取请求

编码标准

  • Python:跟随 PEP 8,使用 黑色 格式化程序
  • PowerShell:关注 PSScriptAnalyzer 规则
  • 承诺:使用 常规承诺

🙏 致谢

这个项目站在巨人的肩膀上:

  • 模型上下文协议 --AI-IDE集成的基础
  • MCP社区服务器 --文件系统、Git、GitHub实现
  • 奥拉玛 --本地LLM推理变得简单
  • Qdrant --高性能矢量搜索
  • 光标 --AI第一IDE

🔗 相关项目

  • MCP规范 --协议文件
  • MCP服务器 --官方服务器实施
  • 奥拉玛 --在本地运行LLM
  • Qdrant --向量相似性搜索

📄 许可证

该项目根据 MIT许可证 --看看 许可证 文件以获取详细信息。```
MIT License

Copyright (c) 2025 AIStack-MCP Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...
```


⭐ 如果这个回购对你有帮助,请加星!

由以下材料制成❤️ 对于MCP社区

报告Bug · 请求功能 · 文档

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Portable MCP Toolkit 怎么安装?

在客户端按下面的安装命令接入:python -m venv .venv。装完在客户端配置里引用同一个包或端点。

Portable MCP Toolkit 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Portable MCP Toolkit 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Portable MCP Toolkit 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Portable MCP Toolkit 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Portable MCP Toolkit 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 本地AI、Python、Claude。具体工具清单以官方文档为准。

Portable MCP Toolkit 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Portable MCP Toolkit 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。