Memory Alpha MCP

内存Alpha MCP服务器

MCP（模型上下文协议）服务器，从 阿尔法记忆 进入你的AI会话。搜索文章、查找剧集、比较星际飞船、模拟战斗、组建团队、参加智力问答，并让Q亲自审查你的代码。

免责声明： 这是一个非官方的粉丝项目。不隶属于哥伦比亚广播公司、派拉蒙或记忆阿尔法。所有内容都是从MemoryAlpha的公共API（CC-BY-SA许可）动态获取的。没有嵌入或重新分发受版权保护的材料。

安装

克劳德桌面版

添加到您的Claude桌面配置(claude_desktop_config.json):

{ 
  "mcpServers": {
    "memory-alpha": {
      "command": "npx",
      "args": ["-y", "memory-alpha-mcp"]
    }
  }
}

克劳德代码

claude mcp add memory-alpha -- npx -y memory-alpha-mcp

手册

npm install -g memory-alpha-mcp
memory-alpha-mcp

需求

• Node.js 18+（使用内置 fetch)

运作原理

建筑

src/
  index.ts              # Entry point: MCP server + stdio transport + graceful shutdown
  api/                   # MediaWiki API client layer
    client.ts            #   HTTP client with rate limiting (5 req/s), retry, 10s timeout, caching
    parse.ts             #   action=parse (wikitext retrieval)
    search.ts            #   action=query&list=search
    categories.ts        #   action=query&list=categorymembers
    random.ts            #   action=query&list=random
    types.ts             #   TypeScript interfaces for API responses
  parser/                # Wikitext parsing pipeline
    wikitext.ts          #   Main parser: wtf_wikipedia wrapper, disambiguation detection
    infobox.ts           #   Brace-balanced sidebar/infobox extraction with regex fallback
    sections.ts          #   Section extraction by heading
  tools/                 # 31 MCP tool implementations
  prompts/               # 22 Trek-themed prompt templates
  resources/             # 7 static reference resources
  utils/
    cache.ts             #   In-memory TTL cache with LRU eviction (5min TTL, 100 entries)
    logger.ts            #   console.error wrapper (never console.log - corrupts stdio)
    text.ts              #   Wikitext cleaning, HTML stripping, truncation, template stripping
    attribution.ts       #   CC-BY-SA attribution footer appended to all responses
    shuffle.ts           #   Fisher-Yates shuffle

关键设计决策

工具（31）

核心工具

search_memory_alpha

在Memory Alpha中搜索《星际迷航》的文章、角色、船只、剧集等。

get_article

从Memory Alpha获取完整或部分文章。使用精确的文章标题以获得最佳效果。

自动检测消歧页面，并返回可用文章的列表。

get_random_article

从Memory Alpha获取随机的《星际迷航》文章。

browse_categories

按类别浏览Memory Alpha文章。

域名工具

get_episode

获取《星际迷航》一集的详细信息：剧情简介、编剧、导演、明星、客串演员。按标题或按系列+季节+剧集号查找。

提供其中之一 title 或全部三个 series + season + episode.

list_episodes

列出《星际迷航》系列的所有剧集。

get_starship

获取《星际迷航》星际飞船的详细信息：等级、登记、武器、船员编制。

species_info

获取有关《星际迷航》中物种的信息：家园、生理、文化、象限。

character_lookup

获取《星际迷航》角色的详细信息：等级、物种、隶属关系、传记、职业史和令人难忘的引语。

从个人/角色/人员模板中提取侧边栏数据。自动检测消歧页面。

get_timeline

获取特定宇宙年的《星际迷航》事件。

on_this_day

获取《星际迷航》事件、播出日期和特定日期的生日。

crew_manifest

获取《星际迷航》星舰或空间站的船员名单。

rules_of_acquisition

按数字、随机或按关键字搜索Ferengi习得规则。规则是从Memory Alpha的文章中动态解析的。

stardate_converter

在标准日期和现实世界日期之间进行转换，或获取当前标准日期。支持TOS时代和TNG时代的转换公式。

提供其中之一 date 或 stardate。如果两者都没有给出，则转换为今天的日期。

有趣的工具

compare

将两个《星际迷航》主题与markdown表中的信息框数据并排比较。

trivia_quiz

根据随机记忆阿尔法事实生成一个《星际迷航》琐事问题。

who_said_it

引用归因挑战——猜猜《星际迷航》中哪个角色这么说。

alien_phrases

查找《星际迷航》中外星语言的短语和词汇。提取结构化的词汇部分（常用短语、词汇、词典等）（如果可用），回到整篇文章文本。

使用已知的文章映射支持克林贡、瓦肯、费伦吉、罗慕兰、巴约兰、卡达西和自治领。其他语言是动态搜索的。

prime_directive_check

用幽默的星际舰队评估来评估一项行动是否违反了最高指令。

从Prime Directive文章中返回违规概率、威胁级别、历史先例和上下文。

red_shirt_analysis

以经典的Trek红衫军风格评估生存几率。

分析描述中的关键字，以计算生存概率、风险因素、可能的死亡原因和推荐的最后一句话。

battle_simulator

根据两艘《星际迷航》飞船的规格进行战术分析。从Memory Alpha获取真实的舰船数据，比较与战斗相关的规格，并生成战斗叙述。

返回规格比较表、战斗概率百分比、预测胜利者和戏剧性的战斗叙述。

away_team_builder

根据机组人员的专业知识，为任务推荐最佳的客场团队组成。分析任务关键字以确定所需的角色，从船员数据库中选择，并评估任务风险。

返回推荐的机组人员、任务分析、所需设备和风险评估。

episode_recommender

根据你喜欢的《星际迷航》剧集获得剧集推荐。分析源剧集的主题和类别，以找到相关剧集。

holodeck_program

生成《星际迷航》全息甲板程序名称、安全评估和故障概率。分析场景以确定分类、复杂性和风险。

返回程序名称、分类、故障概率、环境参数、安全评估和已知风险。

start_trivia_game

为多人游戏会话生成一组《星际迷航》琐事问题。返回一个game_id和问题集，供Clara跟踪每个玩家的分数。

check_trivia_answer

将玩家的琐事答案与正确答案进行核对。完全无状态——Clara从游戏包中传递正确答案。

diplomatic_scenario

在两个派系之间生成一个《星际迷航》外交谈判场景，包括立场、要求和杠杆点。

anomaly_of_the_week

生成一个《星际迷航》太空异常，对飞船产生影响，并可能产生分辨率——经典的TNG氛围。

mirror_universe

描述角色、飞船或事件的镜像宇宙版本。检查内存Alpha以查找专用镜像文章。

first_contact_assessment

给定一个物种名称，查找并评估扭曲能力、政府类型和推荐的首次接触方法。

temporal_incursion

查找一个已知的Trek时间旅行事件，并描述时间悖论及其解决方案。

提示（22）

资源（7）

这些是具有原始描述（不是MemoryAlpha内容）的静态引用资源，可用于上下文，而无需进行API调用。

示例

"Search Memory Alpha for Borg"
"Tell me about the episode 'The Best of Both Worlds'"
"List all episodes of TNG Season 3"
"What are the specs of the USS Defiant?"
"Look up Jean-Luc Picard's character profile"
"Give me a random Star Trek trivia question"
"Check if giving warp technology to a pre-warp civilization violates the Prime Directive"
"What's my red shirt survival odds for exploring an unknown cave alone?"
"Look up Ferengi Rule of Acquisition #34"
"Compare the USS Enterprise-D with the USS Voyager"
"Simulate a battle between the Enterprise-D and a Borg cube"
"Build me an away team for a diplomatic mission on a hostile planet"
"Recommend episodes similar to 'The Inner Light'"
"Generate a holodeck program for a 1940s detective noir mystery"
"What's the current stardate?"
"Convert stardate 41153.7 to a real-world date"
"What happened in Star Trek on February 14?"
"Look up Klingon phrases"
"Explain microservices like Spock would"
"Give me Scotty's estimate for migrating a database"
"Assess this situation as Worf would: the build pipeline is failing"
"Review my code as Q"

发展

git clone https://github.com/yourusername/memory-alpha-mcp.git
cd memory-alpha-mcp
npm install
npm run build   # Compile TypeScript
npm run dev     # Run with tsx (hot reload)
npm test        # Run test suite (146 tests)

测试

该项目包括17个测试文件中的146个单元测试，使用 请柬:

MCP检查员

交互式测试工具：

npx @modelcontextprotocol/inspector node dist/index.js

归因与许可

这个项目（麻省理工学院）

服务器代码本身根据 MIT许可证.

内存Alpha内容（CC-BY-SA）

所有《星际迷航》内容都是在运行时从以下位置动态获取的 MemoryAlpha的公共MediaWiki APIMemory Alpha内容的许可证为 CC-BY-SA 3.0.

归因是如何工作的：

• 每个包含Memory Alpha内容的工具响应都会通过以下方式自动附加归因页脚 withAttribution() 在 src/utils/attribution.ts
• 页脚如下： *“来源：记忆阿尔法（CC-BY-SA）|非官方粉丝项目-不隶属于哥伦比亚广播公司/派拉蒙”*
• 不包含Memory Alpha内容的错误响应不包括页脚
• 七种静态资源(trek://series, trek://glossary, trek://technobabble, trek://starship-classes, trek://factions, trek://prime-directive-cases，以及 trek://technology-index)包含原始参考说明，而不是内存Alpha内容
• 源代码或包中没有嵌入受版权保护的材料——所有wiki内容都是从API实时获取的，并在显示时进行归因

这种方法通过为所提供的每一条内容提供归因、链接到源并标识许可证来满足CC-BY-SA要求。该项目充当API客户端，而不是内容宿主。