MCP Framework深度测评：连接AI与外部世界的神经网络

# 创建项目目录
mkdir my-mcp-server
cd my-mcp-server

# 创建虚拟环境
python -m venv venv
.\venv\Scripts\activate

# 安装核心依赖
pip install mcp aiohttp anyio

# 全局安装Windows MCP.Net工具
dotnet tool install --global WindowsMCP.Net

{
  "mcpServers": {
    "windows-mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["Windows-MCP.Net@", "--yes"],
      "env": {}
    }
  }
}

# 创建虚拟环境
python -m venv venv
source venv/bin/activate

# 安装MCP基础包
pip install mcp aiohttp anyio

# 使用uvx安装特定MCP Server（如syncline）
pip install syncline-mcp-server

{
  "mcpServers": {
    "syncline": {
      "command": "uvx",
      "args": ["syncline-mcp-server"],
      "env": {
        "SYNCLINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

# 更新系统包
sudo apt update
sudo apt install python3-pip python3-venv -y

# 创建项目目录
mkdir ~/mcp-projects
cd ~/mcp-projects

# 设置虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装MCP核心库
pip install mcp aiohttp anyio

# 拉取MCP Server镜像
docker pull mcp/supergateway:latest

# 运行容器
docker run -d -p 3000:3000 \
  -e AMAP_MAPS_API_KEY="your_api_key" \
  --name mcp-server \
  mcp/supergateway:latest

错误信息：ModuleNotFoundError: No module named 'mcp'

# 确保使用正确的Python版本
python --version  # 应为3.10+
# 重新安装mcp包
pip install --force-reinstall mcp

错误信息：Permission denied when installing global package

# 使用用户安装模式
pip install --user mcp
# 或使用虚拟环境
python -m venv venv
source venv/bin/activate
pip install mcp

错误信息：MCP server not appearing in Claude

{
  "mcpServers": {
    "file-system": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-filesystem"],
      "env": {}
    },
    "weather": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-weather"],
      "env": {
        "WEATHER_API_KEY": "your_key_here"
      }
    }
  }
}

# 安装
pip install lite-mcp-client

# 基本使用
uv run lite_mcp_client.main --interactive

# 连接特定服务器
uv run lite_mcp_client.main --server "各平台热搜查询"

# 执行智能查询
uv run lite_mcp_client.main "查询微博热点新闻并总结"

import asyncio
import aiohttp
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.server.models import ToolResult
from mcp.types import Tool

# 创建Server实例
app = Server("amap-geocoding-server")

@app.tool()
async def geocode_address(address: str) -> Tool:
    """根据中文地址获取其经纬度坐标。

    Args:
        address: 详细的中文地址，例如：北京市朝阳区阜通东大街6号。

    Returns:
        返回该地址的经纬度信息。
    """
    # 从环境变量获取API Key，实际使用中应避免硬编码
    AMAP_API_KEY = "your_amap_api_key_here"
    url = f"https://restapi.amap.com/v3/geocode/geo?key={AMAP_API_KEY}&address={address}"

    try:
        async with aiohttp.ClientSession() as session:
            # 设置10秒超时
            async with asyncio.timeout(10):
                async with session.get(url) as response:
                    # 检查HTTP状态码是否成功
                    response.raise_for_status()
                    data = await response.json()

                    # 检查高德API返回的业务状态码
                    if data.get('status') != '1':
                        error_info = data.get('info', 'Unknown error')
                        return ToolResult(
                            content=f"Geocoding API error: {error_info}",
                            isError=True
                        )

                    # 解析并返回结果
                    geocodes = data.get('geocodes', [])
                    if not geocodes:
                        return ToolResult(content="No results found for the given address.")

                    location = geocodes[0].get('location')
                    formatted_address = geocodes[0].get('formatted_address')
                    result_text = f"地址 '{formatted_address}' 的坐标是：{location}"

                    return ToolResult(content=result_text)

    except asyncio.TimeoutError:
        return ToolResult(content="Geocoding request timed out after 10 seconds.", isError=True)
    except aiohttp.ClientResponseError as e:
        return ToolResult(content=f"HTTP error occurred: {e.status} - {e.message}", isError=True)
    except Exception as e:
        return ToolResult(content=f"An unexpected error occurred: {str(e)}", isError=True)

async def main():
    # 使用stdio传输层，这是与Claude等客户端通信的标准方式
    async with stdio_server() as (read_stream, write_stream):
        await app.run(
            read_stream,
            write_stream,
            app.create_initialization_options()
        )

if __name__ == "__main__":
    asyncio.run(main())

# test_geocode.py
import asyncio
from mcp.client import create_session
from mcp.client.stdio import stdio_client

async def test_geocode_tool():
    """测试地理编码工具"""
    async with stdio_client("python", "server.py") as (read, write):
        async with create_session(read, write) as session:
            # 初始化连接
            await session.initialize()
            
            # 列出可用工具
            tools = await session.list_tools()
            print("可用工具:", tools)
            
            # 调用地理编码工具
            result = await session.call_tool(
                "geocode_address", 
                {"address": "北京市朝阳区阜通东大街6号"}
            )
            print("地理编码结果:", result)

if __name__ == "__main__":
    asyncio.run(test_geocode_tool())

{
  "mcpServers": {
    "amap-geocoding": {
      "type": "stdio",
      "command": "python",
      "args": ["/path/to/your/amap_server.py"],
      "env": {
        "AMAP_API_KEY": "your_actual_api_key"
      }
    }
  }
}

用户：查询北京市朝阳区阜通东大街6号的经纬度

Claude：[调用geocode_address工具] 地址 '北京市朝阳区阜通东大街6号' 的坐标是：116.480881,39.989410