SouthAsia by igs-pochenkuo - MCP Server

SouthAsia MCP 工具專案是一個基於 Model Control Protocol (MCP)-like 框架的工具集，專為擴充 AI 助理（如 Cursor）的功能而設計。此工具集允許開發者創建自訂工具，執行更複雜且貼近本地開發環境的任務。儲存庫提供了一個模板和起點，幫助開發者快速上手並擴充功能。此專案支援 Python 3.10 以上版本，並推薦使用 uv 進行套件管理。開發者可以透過簡單的步驟安裝和配置工具，並在 Cursor 中使用 MCP 工具進行交互。

Features

mcp_hello_world: 返回固定的問候語。
mcp_hello_name: 接收一個 name 參數，返回包含該名字的問候語。
易於擴充: 開發者可以輕鬆擴充此專案，加入更多實用工具。
詳細開發指南: 提供詳細的開發指南，幫助開發者創建新工具。
跨平台支持: 支援 Windows、macOS 和 Linux 平台。

MCP Tools

{'mcp_hello_world': '一個簡單的工具，返回固定的問候語。'}
{'mcp_hello_name': '接收一個 name 參數，並返回包含該名字的問候語。'}

Usage with Different Platforms

installation_script

bash
# 1. 克隆儲存庫
git clone <您的儲存庫 URL>
cd southAsia_Tool # 進入專案目錄

# 2. 建立並啟用虛擬環境
# 使用 uv (推薦)
uv venv
source .venv/bin/activate  # Linux/macOS
# 或者 .\.venv\Scripts\Activate.ps1  # Windows PowerShell
# 或者 .\.venv\Scripts\activate.bat # Windows Cmd

# 使用 Python 內建 venv
# python -m venv .venv
# source .venv/bin/activate  # Linux/macOS
# 或者 .\.venv\Scripts\Activate.ps1  # Windows PowerShell
# 或者 .\.venv\Scripts\activate.bat # Windows Cmd

# 3. 安裝依賴
# 使用 uv (推薦)
uv pip sync pyproject.toml

# 4. 使用 pip 編譯工具
pip install -e .

cursor_configuration


{
  "southAsia": {
    "command": "cmd", // 或 "bash", "zsh" 等，依您的系統
    "args": [
      "/c", // Windows cmd 的參數，bash/zsh 通常不需要
      "southasia" // 對應 pyproject.toml 中定義的命令名稱
    ]
  }
}

Frequently Asked Questions