Wikidata MCP Server

Wikidata MCP 服务器

一个使用模型上下文协议 (MCP) 的 Wikidata API 服务器实现。 本项目提供与 Wikidata 交互的工具，例如搜索标识符（实体和属性）、提取元数据（标签和描述）和执行 sparql 查询。

---

安装

如果尚未安装 uv，请先安装它。

$ curl -LsSf https://astral.sh/uv/install.sh | sh

然后，安装依赖项。

$ git clone https://github.com/zzaebok/mcp-wikidata.git
$ cd mcp-wikidata
$ uv sync
# 如果你想一起运行客户端示例
$ uv sync --extra example

---

运行

使用以下命令运行服务器：

$ uv run src/server.py

如果你想用一个简单的客户端代码（使用 langchain-mcp-adapters）来测试它，请使用以下命令运行客户端：

# 在另一个 shell 中
$ uv run src/client.py

LLM 提取有效的实体和属性标识符，执行 sparql 查询，最后推荐一部由奉俊昊导演的电影。

<details> <summary><i>查看执行输出</i></summary>

{
  "messages": [
      HumanMessage(
          content="你能推荐一部奉俊昊导演的电影吗？",
      ),
      AIMessage(
          tool_calls=[
              {
                  "name": "search_entity",
                  "args": {"query": "奉俊昊"},
              }
          ],
      ),
      ToolMessage(
          content="Q495980",
          name="search_entity",
      ),
      AIMessage(
          tool_calls=[
              {
                  "name": "get_properties",
                  "args": {"entity_id": "Q495980"},
              }
          ],
      ),
      ToolMessage(
          content='["P345", "P244", "P214", "P227", ...]',
          name="get_properties",
      ),
      AIMessage(
          tool_calls=[
              {
                  "name": "search_property",
                  "args": {"query": "导演"},
              }
          ],
      ),
      ToolMessage(
          content="P57",
          name="search_property",
      ),
      AIMessage(
          tool_calls=[
              {
                  "name": "execute_sparql",
                  "args": {
                      "sparql_query": 'SELECT ?film ?filmLabel WHERE {\n  ?film wdt:P57 wd:Q495980.\n  SERVICE wikibase:label { bd:serviceParam wikibase:language "en". }\n} LIMIT 1'
                  },
              }
          ],
      ),
      ToolMessage(
          content='[{"film": {"type": "uri", "value": "http://www.wikidata.org/entity/Q483761"}, "filmLabel": {"xml:lang": "en", "type": "literal", "value": "母亲"}}]',
          name="execute_sparql",
      ),
      AIMessage(
          content='我推荐电影《母亲》，它是由奉俊昊导演的。',
      ),
  ]
}

</details>

---

Wikidata MCP 工具

以下工具已在服务器中实现：

工具	描述
search_entity(query: str)	通过查询搜索 Wikidata 实体 ID。
search_property(query: str)	通过查询搜索 Wikidata 属性 ID。
get_properties(entity_id: str)	获取与给定 Wikidata 实体 ID 关联的属性。
execute_sparql(sparql_query: str)	在 Wikidata 上执行 SPARQL 查询。
get_metadata(entity_id: str, language: str = "en")	检索给定 Wikidata 实体 ID 的英文标签和描述。

---

许可证

MIT 许可证