Ziiqii GeoSense MCP Server

GeoSense 企业知识库的 MCP 接口。装在 Claude Desktop 里，直接对话查公司知识。

安装（推荐：npx）

不需要 clone 代码，直接配置 Claude Desktop 即可。

配置 Claude Desktop

编辑配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ziiqii-geosense": {
      "command": "npx",
      "args": ["-y", "ziiqii-geosense-mcp"],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "SEARCH_API_URL": "https://ziiqii-geosense-search.huxinhao640103.workers.dev"
      }
    }
  }
}

获取 GitHub Token

1. GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
2. 创建 token，给 ziiqii-geosense repo 的 Contents 读写权限
3. 填入配置

前提条件

• Node.js 18+（安装后 npx 自动可用）
• Claude Desktop

开发者安装

如果你需要修改代码：

git clone https://github.com/TechHU-GS/ziiqii-geosense.git
cd ziiqii-geosense/mcp
npm install
npm run build

然后在 Claude Desktop 配置里用本地路径：

{
  "mcpServers": {
    "ziiqii-geosense": {
      "command": "node",
      "args": ["/path/to/ziiqii-geosense/mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token"
      }
    }
  }
}

可用工具

查询工具

| 工具 | 功能 | 场景 | |------|------|------| | search_knowledge | 语义搜索知识库（主要查询方式） | 查数据、客户、成果、产品等所有内容 | | read_source | 读取知识库文件全文 | 搜索后需要完整上下文 | | get_tech_description | 获取产品的多版本描述 | 写申报/客户/媒体材料（核心通译） | | get_deadlines | 查公司 deadline | 项目规划 | | get_activities | 查活动索引，按身份筛选 | 年度汇报 | | get_activity_detail | 查某月活动详情 | 汇报材料 | | get_identity_info | 查身份档案 | 汇报 |

写入工具（staging 收件箱）

| 工具 | 功能 | 场景 | |------|------|------| | submit_activity | 提交活动记录 | 访问客户、参会、现场工作 | | submit_client_note | 提交客户信息 | 沟通记录、反馈、需求 | | submit_general | 提交通用信息 | 选题建议、备忘、素材 | | list_staging | 查看收件箱待处理内容 | 管理归档 |

写入工具提交的内容会进入 staging/ 目录，等待创始人或 CC 审核后归档到正式知识库。

v0.4.0 精简了工具数量（18→11）。原有的 get_data_points、get_client_info、get_achievements 等专用查询工具已合并到 search_knowledge + read_source 的通用查询流程中。

使用示例

在 Claude Desktop 里直接说：

• "帮我写一段精准灌溉的申报描述"
• "望月石酒庄是什么情况？"
• "公司节水率数据是多少，来源是什么？"
• "最近有什么 deadline？"
• "用媒体版描述一下我们的气象站"
• "记录一下，今天去了美贺庄园，和张总沟通了二期部署方案"
• "提交一个公众号选题：无人车实验的进展"
• "看看收件箱有什么待处理的"