MCP Client Basic

MCPAI代理

提供方 yinstardev

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

一个包含天气服务和增强代码库语义搜索功能的AI助手模型上下文协议服务器集合,适用于本地开发和云部署。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

AI助手Python本地部署语义搜索本地处理代码分析天气服务

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements_enhanced.txt

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

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

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

多步任务编排

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

自动化重复流程

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

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Client Basic当前 未标注 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代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方yinstardev上游标注的维护方 yinstardev
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

MCP服务器集合

用于AI助手的MCP(模型上下文协议)服务器和客户端的集合。

🌟 包含什么

1. 气象MCP服务器 (weather.py)

  • 获取美国各州的天气警报
  • 获取特定坐标的预测
  • 来自国家气象局的实时数据
  • ✅ 生产就绪

2. 增强型代码库MCP服务器 (codebase_server_enhanced.py)

  • 语义搜索 通过你的代码(理解意思!)
  • 矢量嵌入 使用本地模型(不需要API)
  • 读取文件、列出文件、搜索文本
  • 100%离线工作
  • ✅ 已准备好本地使用和模态部署

3. 聊天客户端

  • chat_with_ollama.py -与Ollama+天气工具聊天
  • chat_multi_mcp.py -与Ollama+天气+代码库工具聊天

🚀 快速开始

选项1:交互式设置```bash

cd /Users/prashant.patil/weather-mcp-server
./quickstart.sh


### 选项2:手动设置```bash
# 1. Activate virtual environment
source venv/bin/activate

# 2. Install enhanced requirements (for semantic search)
pip install -r requirements_enhanced.txt

# 3. Configure your codebase path
# Edit codebase_server_enhanced.py, line 31:
CODEBASE_PATH = "/Users/prashant.patil/mobile-embed"  # ← Your path here

# 4. Test it!
python test_codebase_enhanced.py

# 5. Chat with it!
python chat_multi_mcp.py

📚 你可以问什么

天气问题:

  • “加利福尼亚州的天气警报是什么?”
  • “预测旧金山为37.7749,-122.4194”
  • “得克萨斯州有天气预警吗?”

代码库问题(索引后):

  • “索引代码库”(首次设置)
  • “搜索身份验证逻辑”
  • “查找所有API终结点”
  • “显示配置文件”
  • “数据验证在哪里完成?”
  • “列出所有TypeScript文件”
  • “阅读README.md文件”

🎯 主要特点

语义搜索(魔术!)

传统搜索: grep "login" → 准确找到“登录”

语义搜索: "authentication logic" → 发现:

  • 登录功能
  • 身份验证中间件
  • 令牌验证
  • 会话管理
  • 密码验证
  • OAuth处理程序

它理解你的意思,而不仅仅是你说的话!

工作原理:```

  1. Indexing (one-time):
    Your Code → Split into chunks → Generate embeddings → Store in ChromaDB

  2. Searching (real-time):
    Your Question → Generate embedding → Find similar code → Return results


### 本地和私人:

- ✅ 不需要API密钥
- ✅ 无云依赖
- ✅ 所有处理都在本地进行
- ✅ 你的代码永远不会离开你的机器

______________________________________________________________________

## 📁 文件概述```
weather-mcp-server/
├── weather.py                    # Weather MCP server
├── codebase_server.py            # Simple codebase server (text search)
├── codebase_server_enhanced.py   # 🌟 Enhanced with embeddings
├── chat_with_ollama.py           # Weather + Ollama chat
├── chat_multi_mcp.py             # Weather + Codebase + Ollama
├── test_mcp_client.py            # Test weather server
├── test_codebase_enhanced.py     # Test codebase server
├── weather_api.py                # REST API wrapper (optional)
├── modal_deploy.py               # Modal.com deployment (optional)
├── quickstart.sh                 # Interactive setup script
├── SETUP_GUIDE.md                # Detailed setup instructions
└── requirements_enhanced.txt     # Dependencies for embeddings

🌩️ 部署选项

本地(默认)

  • 立即工作
  • 非常适合开发
  • 无成本

模态(云)

  • 持久嵌入
  • 从任何地方访问
  • 自动缩放
  • 按使用付费

您自己的服务器

  • 完全控制
  • 一次性设置
  • 全天候运行

看 SETUP_GUIDE.md 了解详细的部署说明!


🔧 配置

更改代码库路径

编辑 codebase_server_enhanced.py:```python
CODEBASE_PATH = "/path/to/your/code"
CODEBASE_NAME = "your-project-name"


### 更改LLM模型

编辑 `chat_multi_mcp.py`:```python
OLLAMA_MODEL = "llama3.2:3b"  # or "mistral", "codellama", etc.

调整嵌入模型

编辑 codebase_server_enhanced.py:```python
EMBEDDING_MODEL = "all-MiniLM-L6-v2" # Fast (default)

EMBEDDING_MODEL = "all-mpnet-base-v2" # Better quality


______________________________________________________________________

## 📊 演出

### 小代码库(\<1000个文件):

- 索引:1-2分钟
- 搜索:\<1秒
- RAM:~500MB

### 中等代码库(1000-10000个文件):

- 索引:5-10分钟
- 搜索:1-2秒
- RAM:~2GB

### 大型代码库(>10000个文件):

- 考虑使用Modal
- 或递增索引
- RAM:~4GB+

______________________________________________________________________

## 🐛 故障排除

### “导入错误:chromadb”```bash
pip install -r requirements_enhanced.txt

“找不到代码库路径”

更新 CODEBASE_PATH 在 codebase_server_enhanced.py

“搜索未返回任何结果”

  1. 确保你首先运行了“索引代码库”
  2. 检查文件是否已实际编入索引
  3. 尝试:“获取代码库统计数据”进行验证

“Ollama没有回应”```bash

Start Ollama

ollama serve

Pull a model

ollama pull llama3.2:3b


______________________________________________________________________

## 🎓 建筑```
┌─────────────┐
│    You      │  "Search for auth in my code"
└──────┬──────┘
│
▼
┌─────────────────────┐
│ chat_multi_mcp.py   │  Orchestrator
│  (MCP Client)       │
└──────┬──────┬───────┘
│      │
│      └──────────────────┐
│                         │
▼                         ▼
┌─────────────┐         ┌──────────────────┐
│   Ollama    │         │ MCP Servers      │
│ (LLM Model) │         │ ├── Weather      │
└─────────────┘         │ └── Codebase     │
└────────┬─────────┘
│
▼
┌─────────────────┐
│ Your Codebase + │
│ Vector DB       │
└─────────────────┘

🆘 需要帮助?

  1. 检查 SETUP_GUIDE.md 详细说明
  2. 跑 ./quickstart.sh 用于交互式设置
  3. 测试用 test_codebase_enhanced.py
  4. 检查日志(打印到stderr)

🚀 后续步骤

  1. ✅ 天气测试: python chat_with_ollama.py
  2. ✅ 配置代码库路径
  3. ✅ 索引你的代码:运行聊天并说“索引代码库”
  4. ✅ 尝试语义搜索:“查找身份验证逻辑”
  5. 🌟 准备好云访问时部署到Modal

📝 例子

示例1:查找相关代码```

You: "Show me how authentication works"
```

常见问题

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

在客户端按下面的安装命令接入:pip install -r requirements_enhanced.txt。装完在客户端配置里引用同一个包或端点。

MCP Client Basic 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Client Basic 收费吗?

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

MCP Client Basic 需要 API Key 吗?

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

MCP Client Basic 能提供哪些能力?

资料显示能力标签包括 本地处理、代码分析、Python、搜索、位置天气。具体工具清单以官方文档为准。

MCP Client Basic 需要什么运行环境?

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

MCP Client Basic 是本地还是远程?

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

热门专题

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

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