AI导哈

关键词搜索工具

一个基于FastAPI的MCP服务器，提供文件内关键词搜索功能（不区分大小写）。

  • by chetaniitbhilai
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chetaniitbhilai/Ressl_MCP

使用说明

✅ MCP服务器–关键字搜索工具（不区分大小写）

这个项目很简单 MCP（模型上下文协议）服务器 使用FastAPI构建。 它包括一个工具，允许用户 在文件中搜索关键字 不区分大小写

📄 文档

您可以在此处查看详细文档：
任务文件

📁 项目结构

mcp-server/
├── server.py
├── tools/
│   ├── __init__.py
│   └── search_tool.py
├── requirements.txt
└── README.md

⚙️ 1.设置说明

✅ 步骤1：克隆或创建项目文件夹

cd mcp-server

✅ 步骤2：创建和激活虚拟环境（可选但推荐）

python -m venv venv
# Activate it:
# On Windows:
venv\Scripts\activate
# On Linux/Mac:
source venv/bin/activate

✅ 步骤3：安装依赖项

pip install -r requirements.txt

🚀 2.运行MCP服务器

uvicorn server:app --reload --port 8000

如果成功，您将看到：

Uvicorn running on http://127.0.0.1:8000

在浏览器中访问：

http://127.0.0.1:8000

或API文档（自动生成）：

http://127.0.0.1:8000/docs

🔍 3.文件中的搜索关键字（API用法）

✅ 请求格式（POST /search)

{
  "file_path": "path/to/file.txt",
  "keyword": "example"
}

✅ 示例使用 curl:

curl -X POST "http://127.0.0.1:8000/search" \
-H "Content-Type: application/json" \
-d '{"file_path": "sample.txt", "keyword": "hello"}'

✅ 示例响应：

{
  "results": [
    "Line 2: Hello World",
    "Line 5: hElLo again"
  ]
}

🛠 4.代码摘要

server.py

定义API端点 /search.

✅ 5.特点

✔ 基于FastAPI的MCP服务器 ✔ 不区分大小写的关键字搜索 ✔ 显示关键字所在的行号+文本 ✔ 丢失文件的错误处理

📌 6.未来改进（可选）

  • 🔹 跨目录搜索
  • 🔹 正则表达式支持
  • 🔹 返回JSON {line_number, content} 格式
  • 🔹 文件类型过滤（.txt、.py、.md等）

相关 MCP