首页 - 互联网

从零到一：打造高效的金仓社区 API 集成到 MCP 服务方案

作者: 五速梦信息网
时间: 2026年03月21日 04:40

我将详细讲解如何一步步地将一个API接口封装成MCP服务器，并在实际项目中加以使用。

MCP

初始化 MCP

要初始化 MCP 服务器，首先需要安装 uv 并设置 Python 项目和环境。命令如下： > > > 创建新项目目录 > > > uv init kingbase_service > > cd kingbase_service > > > 创建虚拟环境并激活 > > > uv venv > > .venv\Scripts\activate > > > 安装依赖 > > > uv add “mcp[cli]” httpx > 在所有操作执行完成之后，我们可以进入该目录并打开main.py 文件。文件中包含了一个简单的两个数相加的示例，我们无需关注它，直接删除该内容并重新编写即可。

社区 API

由于社区没有提供任何公开的API接口供我们使用，因此我们只能通过手动抓取接口的方式来获取数据。我们在这里不进行具体的演示，最终的实现代码如下：

from mcp.server.fastmcp import FastMCP
import json
import requests
# 初始化 FastMCP 服务器
mcp = FastMCP(&#34;KingBase&#34;)
def get_search(query,type):
    cookies = {
        &#39;_ga&#39;: &#39;GA1.3.1791910307.1718679034&#39;,
        &#39;__bid_n&#39;: &#39;19029f909db92161118c02&#39;,
        &#39;Hm_lvt_3c01febe06ffa2353036661fdec1f873&#39;: &#39;1718691104,1718792940,1718846376&#39;,
        &#39;sensorsdata2015jssdkcross&#39;: &#39;%7B%22distinct_id%22%3A%2219029f90aad523-090ebfbc937d5e-4c657b58-2073600-19029f90aae77%22%2C%22first_id%22%3A%22%22%2C%22props%22%3A%7B%22%24latest_traffic_source_type%22%3A%22%E5%BC%95%E8%8D%90%E6%B5%81%E9%87%8F%22%2C%22%24latest_search_keyword%22%3A%22%E6%9C%AA%E5%8F%96%E5%88%B0%E5%80%BC%22%2C%22%24latest_referrer%22%3A%22https%3A%2F%2Fcloud.tencent.com%2F%22%7D%2C%22identities%22%3A%22eyIkaWRlbnRpdHlfY29va2llX2lkIjoiMTkwMjlmOTBhYWQ1MjMtMDkwZWJmYmM5MzdkNWUtNGM2NTdiNTgtMjA3MzYwMC0xOTAyOWY5MGFhZTc3In0%3D%22%2C%22history_login_id%22%3A%7B%22name%22%3A%22%22%2C%22value%22%3A%22%22%7D%2C%22%24device_id%22%3A%2219029f90aad523-090ebfbc937d5e-4c657b58-2073600-19029f90aae77%22%7D&#39;,
    }
headers = {
        &#39;Accept&#39;: &#39;application/json, text/plain, */*&#39;,
        &#39;Accept-Language&#39;: &#39;zh-CN&#39;,
        &#39;Connection&#39;: &#39;keep-alive&#39;,
        &#39;Content-Type&#39;: &#39;application/json;charset=UTF-8&#39;,
        # &#39;Cookie&#39;: &#39;_ga=GA1.3.1791910307.1718679034; __bid_n=19029f909db92161118c02; Hm_lvt_3c01febe06ffa2353036661fdec1f873=1718691104,1718792940,1718846376; sensorsdata2015jssdkcross=%7B%22distinct_id%22%3A%2219029f90aad523-090ebfbc937d5e-4c657b58-2073600-19029f90aae77%22%2C%22first_id%22%3A%22%22%2C%22props%22%3A%7B%22%24latest_traffic_source_type%22%3A%22%E5%BC%95%E8%8D%90%E6%B5%81%E9%87%8F%22%2C%22%24latest_search_keyword%22%3A%22%E6%9C%AA%E5%8F%96%E5%88%B0%E5%80%BC%22%2C%22%24latest_referrer%22%3A%22https%3A%2F%2Fcloud.tencent.com%2F%22%7D%2C%22identities%22%3A%22eyIkaWRlbnRpdHlfY29va2llX2lkIjoiMTkwMjlmOTBhYWQ1MjMtMDkwZWJmYmM5MzdkNWUtNGM2NTdiNTgtMjA3MzYwMC0xOTAyOWY5MGFhZTc3In0%3D%22%2C%22history_login_id%22%3A%7B%22name%22%3A%22%22%2C%22value%22%3A%22%22%7D%2C%22%24device_id%22%3A%2219029f90aad523-090ebfbc937d5e-4c657b58-2073600-19029f90aae77%22%7D&#39;,
        &#39;Origin&#39;: &#39;https://bbs.kingbase.com.cn&#39;,
        &#39;Referer&#39;: &#39;https://bbs.kingbase.com.cn/&#39;,
        &#39;Sec-Fetch-Dest&#39;: &#39;empty&#39;,
        &#39;Sec-Fetch-Mode&#39;: &#39;cors&#39;,
        &#39;Sec-Fetch-Site&#39;: &#39;same-origin&#39;,
        &#39;User-Agent&#39;: &#39;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36 Edg/126.0.0.0&#39;,
        &#39;sec-ch-ua&#39;: &#39;&#34;Not/A)Brand&#34;;v=&#34;8&#34;, &#34;Chromium&#34;;v=&#34;126&#34;, &#34;Microsoft Edge&#34;;v=&#34;126&#34;&#39;,
        &#39;sec-ch-ua-mobile&#39;: &#39;?0&#39;,
        &#39;sec-ch-ua-platform&#39;: &#39;&#34;Windows&#34;&#39;,
    }
    tpe = f&#39;kingbase_blog_{type}&#39;
    json_data = {
        &#39;keyWord&#39;: query,
        &#39;type&#39;: tpe,
        &#39;pageNum&#39;: 1,
        &#39;pageSize&#39;: 5,
        &#39;fullSearch&#39;: True,
    }
response = requests.post(
        &#39;https://bbs.kingbase.com.cn/web-api/web/search/queryByKeyWord&#39;,
        cookies=cookies,
        headers=headers,
        json=json_data,
    )
    return response.text
@mcp.tool()
def kingbase_serach(query: str, type: str) -&gt; int:
    &#34;&#34;&#34;
    查询kingbase论坛和博客
    query:查询内容
    type:查询范围固定值：论坛：forum，博客：posts
    &#34;&#34;&#34;
    return get_search(query,type) 
if __name__ == &#34;__main__&#34;:
    print(&#34;Starting MCP server...&#34;)
    mcp.run(transport=&#39;stdio&#39;)

可视化测试

MCP依赖默认提供了一个可视化界面，方便用户进行简单的测试操作。通过该界面，用户可以快速验证本地环境是否能够正常运行，确保系统配置正确无误。测试命令如下： > > > mcp dev main.py > 执行完相关命令后，控制台会输出本地服务的IP地址和端口号。点击该链接，将能够在浏览器中查看到相应的效果，如下图所示：看起来都是正常的。

插件配置

我们现在配置一下腾讯云的 CodeBuddy 编程助手插件，并在里面添加如下配置信息：

&#34;mcp-kingbase-server&#34;: {
  &#34;command&#34;: &#34;uv&#34;,
  &#34;args&#34;: [
    &#34;--directory&#34;,
    &#34;D:/project/python/mcp-server/kingbase_service&#34;,
    &#34;run&#34;,
    &#34;main.py&#34;
  ]
}

配置成功后，就会成功解析我们写的工具，效果如图：接着，我们就可以开始使用配置进行随时随地的查询了。